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WELCOME 
to The MagPı 81 


uilding a Raspberry Pi project sounds so simple. Take your 
favourite single-board computer, add a few parts, sprinkle some 
code, and share your creation with the world. 

With a few components, you can turn a Pi into a weather station, 
or a camera, or a wheeled robot. Building projects is what The MagPi 
magazine is about; it’s what the Raspberry Pi community is about. It’s 
what brings us together. 

The challenges in project building are as much psychological as 
physical. Where do you get good ideas from? How do you get started? 
What makes for a good project look? And how can you make sure it 
solves a problem (and does so well)? 

This month, we look at the nuts and bolts of project planning, 
building, and execution (page 26). We’ve asked some of the 
community’s greatest makers to share tips and tricks. What makes a 
really great project; what kit should you have; how to plan and execute 
a project for maximum effect. 

The result is a classic tutorial that gets right to the heart of what 
it means to be amakerinthe 
modern world. We’re delighted T OF 10 HIFIBERRY DAC KITS 
with this month’s feature and Th | & 


found it remarkably helpful. We 
hope you do too. 


Lucy Hattersley Editor 
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Lucy 
Hattersley 


Editor of The MagPi. 
Lucy codes, crafts, 
and creates wonky 
robots. She speaks 
French (badly) and 
mangles the piano. 
One day she'll get 
that pet dog. 
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hosts successful 
Space mission 


Robot-roustabout more challenging and engaging than ever, By Rosie Hattersley 


a. in ingredients: Raspberry Pi-powered 
Credit: SimUK - vehicles customised or designed from 
Pushing the puzzle j scratch, challenging courses, and a multitude of 
obstacle on the opportunities to pit your personal Pi-bot against 
Apollo 13 course Ber Er 
Credit: SimUK i similarly competitive souls. Spread over two days, 
there are school, individual, and team categories, 
neatly encouraging entrants from newbies to near- 
veteran robot builders to take part. 
Or, like us, you can just go along and cheer 
on all-comers. Nearly 500 spectators attended 
this year and enjoyed watching more than 250 
entrants from all over the globe take on seven 
different challenge courses. 


A A robot navigates N | p i Wars has always had a great set of 
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A Billy Cortei's Space Babbage takes on the Asteroid Field 
Credit: SimUK 


Robots in space 

In honour of the 50th anniversary of the Apollo 
Moon landing, this year’s Pi Wars event - held 
at Cambridge Computer Laboratory, on 30 and 31 
March - was space-themed. As ever, competition 
places were snapped up months ago and 

serious building undertaken, not least because 
organisers Tim Richardson and Mike Horne 
warned Pi Wars 2019 would be more challenging 
than ever. Mike said many competitors embrace 
the space theme “with everything from a Mars 
Rover-alike rocker bogey system to a robot that 
looked like Starbug from Red Dwarf.” 


Ei Many a Pi-bot came a 
cropper on the travellator 
built by PiBorg El 


The rough terrain, remote control fetch- 
and-carry challenge Spirit Of Curiosity, and the 
autonomous maze navigation task Canyons of 
Mars were popular additions to what was the 
fifth Pi Wars event. The former was crafted 
from plaster, wood, and bandages by course- 
building supremo Tim. Another stalwart, target 
hitting, became an eighties Space Invaders retro 
gaming corner. 

One existing course got a surprisingly 

tricksy tweak to become the ‘freshly kinked’ 
Straight(ish) Line Speed Test, while Mike tells 
us that competitors found the Hubble Telescope 
vision course especially challenging. 
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Raspberry Pi 3B+ gets a new 
outlook 


Versatile enclosure system for 
Raspberry Pi 3B+ 


The USC-RPI Universal Case System 
securely holds the Raspberry Pi 3B/* & 
official 7" touchscreen with lots of room 


for additional electronics. 


Available in 2 colours, 4 sizes & 2 heights 
with optional wall, desk & DIN rail 


mounting adaptors. 


For additional information call 0845 881 2222 or visit 


phoenixcontact.co.uk/UCS 
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INSPIRING INNOVATIONS 
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PiDrogen about to 
take on travellator 
Credit: Christopher 
Parrot 


We were also 
delighted with John 
Chinner's Yuri 3 Mars 
Rover replica, and the 
Featherstone Rover 
and Rocky Rover 
Credit: Harry Brenton 
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Many a Pi-bot came a cropper on the 
travellator built by PiBorg as part of the Apollo 13 
Obstacle Course, and was hurled off into a canyon 
to lick its electronic wounds. Head-scratching 
also ensued later in the same course at Coretec 
Robotics’ puzzle section. 


Meet the judges 

Dr Lucy Rogers once again honoured Pi Wars as 
head and technical judge, while Raspberry Pi 
founder Eben Upton was ably assisted in his Pi 
Noon judging capacity by two-year-old daughter 
Aphra. Pi Noon always draws a crowd, with 
spectators jostling for room on the two galleries 
above the jousting area. More than 100 balloons 
were Sacrificed at Pi Noon, says Mike. 

Pi Wars isn’t just about competition, though. 
It’s also a marketplace for Raspberry Pi vendors 
such as The Pi Hut (thepihut.com) and Pimoroni 
(pimoroni.com), as well as a showcase for more 
advanced robots such as SB Components’ PiArm 


Pi Wars hosts successful space mission 


Mike and Tim handing out the awards Credit: Colin Grant 
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Pi Wars 2019 winners 


Mike and Tim would like to extend thanks to Dr 
Lucy Rogers for being head judge again this year, 
and more than 70 volunteers who helped make the 
event possible. 

Competitors represented ten different countries, 
including Turkey, Nigeria (which had three teams 
in attendance), Malaysia, China, Hong Kong, and 
Australia, as well as Scotland, England, and Wales. 
Competitors received Arduino-based badges made 
by Gareth Davies at 4tronix. Gareth also made the 
large circuit-board-based trophies. 

There were 37 school teams - for the first time, 
every single school team actually showed up on the 
day - and 37 individual teams on the Sunday. All the 
winners were first-time champions. 


Schools (novices) - Lunokhod 1 

Schools (experienced) - Bobby Tables 
Beginners - Crumble 

Intermediate - PiDER 3.0 

Advanced - PiDrogen 

Technical Merit - Bobby Tables (Saturday); 
Coretec Robotics / Face Plant (Sunday) 
Artistic Merit - Latymer Space Pigs (Saturday); 
Mini Mouse (Sunday) 


Mike and Tim were awarded their own Pi Wars 
trophy and specially commissioned @smolrobots 
artworks, and were given leisure vouchers so they 
could take their long-suffering wives away for a 
much-needed break. 


and PiMecha (sb-components.co.uk). We were 
also delighted by PiBorg’s new three-wheeled 
RockyBorg robot (look out for more news on this 
one soon, piborg.org). 

Tim and Mike are currently weighing up 
options for future events, and they are asking 
folks to sign up for the Pi Wars newsletter 
for more information on the next event: 
piwars.org/mailing-list. 


File Edit 


Tools Window Help 


Y 


File Edit 


Tools Window Help 


Projects +Y FO 4 cpp se F ° „ou 
[ad = s je 
weicme = weverpemo > void Controller Welcome 275 
» & MoverDemoApp 
x MotorLeft = BaseSpeed - PIDLeft Temperature Humidity * mainWindow 
7 | MoverDemoLib MotorRight = BaseSpeed + PIDLeft 
» m Headers ILES br E 100 + © centralwidget 
» t Sources > void Controller Grid Layout 40 80 Ja dak conten 
» $5 Other files MotorLeft = BaseSpeed + PIDRight Form Layout = 30 60 
MotorRight = BaseSpeed - PIDRight + cdpBaseStacke 
s Spacers 20 40 
Overview e 
= void Controller 2 20 PM 
o— o— 
MotorLeft = MotorRight = static_cast<double>(DriveStraightSpeed pun ~ M widge 
+ Containers d EN ed 
> void Controller Temperature Humidity i, 
Configure contu =) Group Box 
> if (Sensorleft > SensorRight Š scroll Area inia 
WotorLeft = static cast-double-|TurnSpeed mainWindow : CDPBaseMain. 
NotorRight - 5 Pressure. ee n 
Analyze Hy Analyze Toperty = 
> else 
= 0 0 - CDPBaseMainWindow 
Motorteft = 5 
MotorRight = static cast<double>(TurnSpeed c » libVersion 35: 
Open Documents nx) Qj CDPBas...Widget € € 
D 
== ~ Input Widgets p" 7 / Es = 
ontrosencpp. v Controller — I bl off + fullScreenkey Ctrl- 
Controller.h RUE CDPBaseLineEdit 
CDPBas. stylingType Defa 
j pixBgLock D 
* Change state only if robot has not seen any wall TRANSITION TO DRIVE TIMEOUT_SEC seco 
3 » pixBackground :/the 
- Controller er 
ME i » cssfile 
p- K Issues Alarms Search R. Applicatio.... Compile General Connecti... p- +K issues Alarms Search R. Applicatio... Compile General Connecti... 
File Edit Tools Window Help File Edit Tools Window Help 
m < > | System con pov b GPlOServer : [a ° 
* E MoverDemo m - EJ MoverDemo 
Welcome 
+ iil MoverDemoay ~ il MoverDemo 
Anaa Name Model Nr Internalvalu: Value Input ^ —ss Untitled 
» wl cop SER = » a COP 
GPIOServer MORD = GPlOServer J Mov 
ADS1115I0: = ADS1115IOServe/ “Om o 
anakan PowerButton ix s 100,000 
Controller utem Controller uc 
ightButton 3 
MoverDemotib ‘ " MoverDemoLib. 
Name Model Input Internalvalu: Value Unit ^ 
umberofNod 
A 
MotorLeftPWM ^ 
Configure. 1 
MotorRightPWM š ur lh 
50,000 Uy 
ison š f | ] 
‘ , Ee] Fur j | IM 
w. i 
= | i m 
+ CANOpenio à Name Value Unit Type Min Max ~ MoverDemoApp Wl |! if in 
» CDPCore gnalTimeout E » CDPProperty | || hy 
+ CDPLogger o R > CDPMessage | h š is In 
> ForceFeedbackjoystick = " vá = CDPSignal<double> Li || y | | | ! J 
+ GPIOPInIO Process Timer Wu Joe. VU Lut lU ten LA lif 
0,000 
» 12C10 Name Description [i] Process Period eo 
+ Modbusio Null Help CPULoad Top 
02.2 
» Modbusio_deprecated Memused 14:19:30,000 
» MQrrio MemUsedRelative 
» NMEAO18310 MemTotal ° 
, ^ h 
— . Name Type Value Description SaveOnCha. LogEv^ . Memauffcache » 
a» Issues Alarms Search R. Applicatio... Compile General Connecti. 2 x Issues Alarms Search R. Appliaio.. Compile General Connecti. 


CDP Studio is a development platform for industrial control systems, now coming with a free 


version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 
and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStudio 


Young refugees get 
Started with Code Club 


Children of families who have resettled in Cambridge are learning 
new tech skills, reports Rosie Hattersley 


supporting a member come about when a group of tech 
of her Code Club 
enthusiasts get together and decide 
they want to share ideas with each other or at 
school. But you don’t have to be a teacher or tech 
evangelist. You can simply learn as you go. 
This is exactly what’s been happening at 
a Code Club in Cambridge, which was set up 
by Nina Szymor, translation manager at the 
Raspberry Pi Foundation, in collaboration with 
Cambridge Refugee Resettlement Campaign 
(CRRC, magpi.cc/sNKqKw). 
Nina set up the twice-monthly club with no 
technical expertise, but armed with plenty of 
Code Club resources and supported by a group 


A Nina Szymor R aspberry Pi Jams and Code Clubs often 


10 | magpi.cc | Young refugees get started with Code Club 


of volunteers. She became involved due to her 
own volunteering efforts with CRRC and saw 
an opportunity to help children of families who 
have resettled in Cambridge to learn valuable 
new skills. “Idon’t have a technical background 
or experience working with kids; Ineeded some 
support and guidance,” reveals Nina. Witha 
keen crew of youngsters eager to learn, she set 
about learning on a project-by-project basis so 
she could show the club members how to work 
through them themselves. “I love seeing the 
pure joy on children’s faces when they make 
something work,” she adds. 

The club takes place at the Raspberry Pi 
Foundation offices in central Cambridge. “Seeing 


THE WORLD OF PI | MägPi Wasa 


A The children can 


learn computing and 


m | love seeing the pure joy on children's faces an 
when they make something work @ 


the amazing work we do as an organisation by children who had already attended several 
inspired me to take personal responsibility for sessions. One girl stepped in and showed 
giving children the opportunity to experience newcomers how to use Scratch and how to make 
coding and technology,” says Nina. best use of the Code Club materials. It’s often 
When the club started in September 2018, said that one of the best ways of embedding your 
many of the children had never used a computer learning is to show someone else what you’ve 
mouse; now that original cohort has mastered been taught. This Code Club is proof positive. 
Module 1 of Scratch. Nina held an end-of- “All the resources are handed to you, and 
term certificate ceremony to which their proud you are guided by the Code Club team,” 
families were invited. Nina reassures anyone keen to replicate her 
A lack of pre-existing computing skills example and set up a Code Club too. If that 
was only one barrier. Some attendees are sounds like you, head to magpi.cc/hBfadS to find 
still learning English, but were ably helped out more. Hl 
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Seans Robot 


Edge detecting, face detecting, and voice-controlled 
- this happy robot can do it all, Rob Zwetsloot finds 


Sean | 

Glendinning out more about it 

A 10 year-old obots with faces don’t always work, we “For my Gold CREST Award project, I decided 
S4 student from » : . : : 

Aberdeenshire R find. Sometimes they can be just creepy. to design and build a robot powered by the 

who enjoys Sean Glendinning’s robot is a bit different, Raspberry Pi computer system,” Sean tells us. 
physics, maths, though, in that it’s kinda cute. Which is great, “The robot is able to detect edges, faces, and 


and programming. 


as due to its face-sensing capabilities it will some voice commands. It moves around on 
sometimes look at you. caterpillar tracks and if it detects a face, it reacts 
by tilting its head.” 


something much more rea 
would at school. Apparent 
can take more than 70 hou 

“This was a challenging 


to keep costs down. There 


A The face is powered by a 
tiny 128x32 OLED display 
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CREST (crestawards.org) is a scheme to get 
young folks into STEAM subjects by contributing 


and practical than you 
y, a gold award project 
rs to complete. 

build, but it was really 


fun and I learned a lot,” Sean continues. “I 
designed the 3D- printed chassis myself, using 
skills I learned in graphic design at school. I had 
quite a lot of the required electronic components 
already, and I tried to improvise where I could 


are some special 


components, though, like a USB microphone and 
the 3D- printed chassis, that I had to buy online. 


Mägpi 


If the robot sees you, 
it will look up and 
make eye contact 


Distance sensors The robot's chassis 
beneath the robot I is entirely custom 
and on its front 3D-designed 
detect if there's | and printed 

a wall or sudden 

drop ahead 


The Pi Zero W used 
is from The MagPi 
subscription offer 


The design is 
inspired by the Anki 
Vector robot 


The square design is very 
practical, and shows off a 
lot of its functionality 


Camera vision on 
the Raspberry Pi 
can be achieved 
via OpenCV 


Its guts are packed with 
hardware that is quite 
neatly arranged 


There are four 
IR sensors on 
the robot - two 
on the front, 
two underneath 


The CREST awards 
are open to all UK 
schoolchildren 
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I tried to make the robot have a friendly design 
and personality, and able to move around without 
bumping into things.” 


From arms to tracks 
Sean has been building robots for years, albeit 
much simpler robot arms - the kind you see in 
/ factories building cars, or as Pi kits like MeArm 
Pi and PiArm. 
“The first one I built in 2015, was made of 
plywood and held together with glue,” Sean 
recalls. “The second one was made of laser-cut 


lithium 


its 


14 magpi.cc Sean's Robot 
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Edge or wall? 


Wall 
IR 
Sensor 


Main Chassis 


IR 
Sensor 


Caterpillar track 


Ground 


01 The infrared sensors at the front detect a 
surface, or the IR sensors on the bottom 
detect a lack of a surface, so there is either a wall or 

a cliff in the robot's path. 


i 


IR 
Sensor 


š ; y A Atable is its natural habitat 
acrylic plastic. Neither of these arms actually 


worked, as they were both quite badly designed. 

The third arm was built in 2018, and I spent three 

months designing it. It was made of thick plywood mds 
and aluminium braces, which held together a lot 

better than the other two arms." 


Main Chassis 


Caterpillar track 


m | had quite a lot of the required electronic 
components already, and | tried to improvise 
where | could to keep costs down @ 


02 The Raspberry Pi is constantly monitoring the 
IR sensors via the GPIO header, and runs the 
results via the software. 


After being inspired by a toy robot, Sean decided 
to build a more mobile kind of robot using a 
Raspberry Pi. 

“I have used the Raspberry Pi for a number 
of projects, and knew that an Arduino wouldn’t 
be powerful enough for speech or face 
recognition,” he reveals. “For its size and cost, 
the Raspberry Pi has a powerful processor and 
was able to handle the complicated speech and 
face detection libraries.” 

The robot uses IR distance sensors arranged 
around the chassis for its edge/wall detecting, 
along with a Raspberry Pi Camera Module 
for face detection, all housed within its own chip to turn the motors in the opposite way, 
3D- printed case. We think it's a great build, and moving the robot backwards, then turn the motors so 
look forward to seeing what robots Sean makes the robot faces a different direction. 
in the future. 7 


The program sends signals to the motor driver 
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The audio sources are GTA: San 
Andreas's in-game radio stations, 
featuring music (over many 
genres), talk-shows, and comedy 


This classic Optalix TO100 radio 
retains its original speaker, 
allowing a more authentic sound 


GTA: F 
San Andreas 
Radio Set — 


project is a stalwart of the community. 

Pi computers the world over have rescued 
otherwise defunct devices from the rubbish 

. . heap and are often cited as a great example of 
Raphaél Yancey is a š E 
Maker and'müsician upcycling. When Raphaél Yancey, a maker from 
from Paris, France, Paris, France, was gifted his grandfather's Optalix 


with a keen interest TO100 radio, he decided to take this classic project 
in programming. 


T he ‘Raspberry Pi in a vintage radio’ 


Raphaél 
Yancey 


; to the next level. 
electronics, Ë: 
and music. Raphaél’s love of Grand Theft Auto: San 


Andreas’s in-game radio stations inspired him. 
“It’s always a pleasure to steal luxury cars and 
drive way too fast while listening to good music! 
The hilarious talk-shows and skits make it even 
more real,” he tells us. When the complete set of 
station recordings was released by Rockstar, some 
new ideas for a project started to form. 


magpi.cc/VrTLVp 
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The original controls are replaced by two 
rotary encoders: one for volume and another 
to ‘tune’ between the various stations 


— ^ ES NA 
This vintage radio plays GTA's radio stations, all in 


real-time. You can even tune between them. 
PJ Evans talks to maker Raphaél Yancey 


He explains, *I thought of a way to listen to the 
radio stations ‘in context’ without launching the 
game. A radio set was the perfect choice, because: 
first, I had a spare one on hand; second, being 
able to move between the stations would make it 
real, like it's taken right out of the game." 


Touch that dial 

Raphaél’s radio plays five stations from the game 
in real-time. The radio features a ‘tuning’ knob 
(a rotary encoder) that switches between each 
station, complete with cross-fade. When you're 
listening to one station, the others continue 

to play silently, making for a more realistic 
experience. “I was really looking forward to 
turning that knob, changing station, and then 
coming back to the first station to see it has 


A Inside the radio. Note the stripped- 
down USB audio card used to offload 
the audio processing 


SER 


lived its life without me listening to it! That little 
feature is what makes it real in my opinion.” 


One of the two KYo40 rotary 
encoders used to control the radio 


Channels funnel 

The hardware side of this inspiring project was 
straightforward enough: a Raspberry Pi 3, two rotary 
encoders (tuning and volume), with an amplifier to 
power the original speaker. The challenges lay in 
the software. The Pi would have to be playing five 
channels concurrently, one per station. Would it 
be able to handle it? *The audio was really glitchy 
when playing multiple files with the built-in 
Raspberry Pi DAC,” recalls Raphaél, “so I bought a 
cheap USB DAC (kind of a sound-card-on-a-stick) 
to offload this work." 

A further challenge was to be able to elegantly 
cross-fade between each station, rather than a 
straight, jarring cut. “I also struggled to find an 
audio mixer Python library that fitted my needs 
(controlling volume and position of multiple 
audio tracks) and benchmarked all of them before 
choosing swmixer.” 

After some maths to work out an elegant 
‘fade’, the project was complete. A hit with 
the community, it was featured on many 
popular maker sites, including the Raspberry Pi 
Foundation’s blog. 

Are there any further plans for the radio? “A 
feature that was requested a lot was to add static 
between stations to make it even more real,” 


out of the game A 


says Raphaél. “I could also optimise the code to 
not play every track at the same time and rather 
only play audible stations. In the meantime, 
every contribution is welcome on the GitHub 
repository: magpi.cc/wDBwEN." [l 
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» There are five 
stations, from 
887MHz to 
108.0MHz 


This radio used 
costs around £20 
on auction sites 


v 


v 


The project can 
run for hours on 
batteries 


» The rotary encoders 
are the popular 
KYo40 type 


» Raphaél wrote a 
Python library for 
the KYo40s 


< With the speaker removed, 
we can see an elegant 
power solution which offers 
more flexibility over the 
Pi's location 


M Being able to move between the stations 
would make it real, like it's taken right 
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Commodore 
monitor 


Testing the notion that good things come in small 
packages, this tiny replica monitor was created for 
Commodore 64 gaming. David Crookes reports 


a firm favourite among enthusiasts of 

retro gaming, thanks to its ability to 
emulate classic computers and consoles from a 
bygone era. Many use packages such as RetroPie 
to create machines capable of playing games from 
multiple systems. These are usually hooked up to 
the makers’ big-screen televisions. 

When Chris Mills decided to emulate the 

Commodore 64, however, he had smaller 
ambitions. Inspired by the recently-launched 


0 ver the years, the Raspberry Pi has become 


Chris has had 


an interest in miniature, THEC64 Mini, he set about producing 
computers since a tinier version of the age-old Commodore 1702 
the late 19705. He monitor. Or at least he did eventually. “The 

got a Commodore PE I 

128 in 1985, and original idea was to make a small box to hold the 
says he likes getting monitor and a Raspberry Pi strictly for Commodore 
things to work as emulation,” he says. “I wasn’t really planning on 


much as actually 


een m » 
using them. making it guite as elaborate as it turned out to be. 


magpi.cc/VKPkzy 


Mini marvel 
Chris likes the Raspberry Pi, which is why, 
despite buying THEC64 Mini and enjoying its 
plug-and-play nature, he prefers using the Pi for 
his Commodore 64 games. “I can get alot more 
software to run on it,” he tells us. This is mainly 


P No that's nota 
huge joystick: it's a 
standard size, but 
it shows just how 
small the monitor 
is. THEC64 Mini sits 
in front 
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A Cables run from the circuit board of the monitor to the back 
of the new case, so that the connectors are easily accessible 
Components are cooled by a fan 


m You wouldn't believe how 
loud a ‘silent’ 50mm fan is 
in a box that size Ej 


due to him running the Combian 64 emulator, 
which is a distribution based on an app called Vice. 

“Its single purpose is Commodore emulation, 
and it boots from a cold start to the blue 
Commodore screen in just a few seconds," he 
explains. “It seems a bit closer to the real hardware 
experience of a Commodore computer to me and 
control seems far less laggy." Hooked up to the 
monitor and with the mini-C64 to its side, along 
with a joystick, it makes for an impressive setup - 
in appearance alone if nothing else. 


Security monitor 

To achieve the look, Chris chose a small TFT LCD 
security monitor. *It needed to have a 4:3 aspect 
ratio since the display would be for a computer 
with 320x200 resolution,” he says. “I also wanted 
something that would sit on my desk without 
taking up too much space. I can't imagine a 
Commodore 64 displaying on a 32-inch television, 
and I grew up with a 13-inch CRT for my computers 


**** COMMODORE 
B4K RAM SYSTEM 


The Commodore 64 was 
renowned for its SID music chip 
that deserve to be heard at their 
best. “I may add a headphone 
jack to connect to a larger 
sound system," Chris tells us 


so an 8- inch size seemed like a nice compromise 
for space versus readability.” 

The HD monitor was placed inside a wooden 
case which Chris designed and crafted himself. He 
removed the back of the display, connected wires 
to the newly created back of the retro monitor, and 
wired a pair of two-inch speakers - which proved 
the trickiest part. 

“I didn't find out that the speaker mounting 
holes and the bezel holes didn’t line up until I 
went to put the speakers in the enclosure," he 


says. He also added a series resistor to drop the fan 
voltage from 12V to 4V. “You wouldn't believe how 
loud a ‘silent’ 5o mm fan is in a box that size,” he 
laughs. “All these years, 've been mistaken in my 


) ) 


interpretation of the world ‘silent’. 
For the finishing touch, the box was fine- 

sanded as smoothly as possible and painted using 

Krylon spray enamel, wet-sanded with 2000 grit 


64 BASIC U2 3*3 
398911 BASIC BYTES FREE 


Chris would like to use the Pi's GPIO pins 
to light an LED to show data transfers, 
but he's happy his Pi/monitor combo 
lets him play his favourite C64 games 


- 


paper between coats. Chris then took a photo of 

a Commodore badge from one of his real 1702 
monitors. *I cropped the picture and made a metal- 
looking Commodore logo,” he says. This was placed 
on the front of the mini monitor. “It’s had a great 
reaction from Commodore fans." M 


Magn NENNEN 


Thanks to Combian 64, Chris 
found there was nothing 

to do except configure the 
display and fiddle with the 
emulation settings 


um 


Quick FACTS . 


» The project cost a 
total of $120 


» It took around 25 
hours to make 


» The case is made 
of painted wood 


» The Pi uses the 
C64 emulator, 
Combian 64 


» Currently, the Pi sits 
outside the monitor 
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Joe is an Android 


engineer working 
remotely at Buffer, 
currently from 
Brighton in the UK. 
He is also a Google ks 
Developer Expert | 
in Android, Google B 
Pay, and Flutter. 


chordassist.com 


An LCD screen shows chord 
diagrams; alternatively, there's 
a Braille reader on the other 
side of the guitar 


Users can talk to the 
guitar and receive 


spoken responses via 
the built-in speaker 


Chord Assist 


magpi.cc 


The Raspberry Pi 
and other electronic 
components are 
hidden inside the 
guitar body, without 
greatly affecting 

its sound 


M Cutting the holes in the guitar and 
then putting all of the parts inside 
became quite a tedious task Ej 


Chord Assist 


With a built-in Al voice assistant, this accessible smart 
guitar can help almost anyone learn to play. Phil King 
starts strumming 


earning to play the guitar can prove 
difficult for people with sight or hearing 
loss. Joe Birch's accessible Chord Assist 
guitar is intended to make the process a whole lot 
easier for deaf, blind, and mute people. 

In Joe's family runs a condition known as 
retinitis pigmentosa, which causes tunnel vision 
over time; it has affected his mother, who is 
now registered partially sighted. “Being closer 


to people who have this condition opened up my 
awareness of how it can effect peoples lives," 
explains Joe. “Currently, music is something that 
is not so accessible to everyone, so I started to 
think of ways in which it could become accessible 
- which is where the idea for Chord Assist 

came from.” 

As well as an LCD screen, four-digit display, and 
buttons to show and select chords, Joe's modified 
acoustic guitar features a Braille reader based 
on his earlier BrailleBox news-reader project 
(magpi.cc/LpjrGF). There's even a vibrating 
progress indicator next to the reader, to indicate 
when a request is taking place. 

In addition, the user can make a spoken request 
for a chord using the built-in mic and Google- 
based voice assistant, and hear a response via 
the speaker. Also capable of playing a requested 
note for tuning purposes, this system makes use 
of Joe's Chord Assist app (magpi.cc/xUAQNo) on 
the Actions on Google platform, which can also be 
used as a standalone learning aid on smartphones 
and other devices. 


Hidden components 
The whole project took Joe around six months 
to complete. “The most difficult part was 
definitely the last stages of the build process - 


PROJECT SHOWCASE | Mägfi 


š " š > Á The Braille reader on the 
cutting the holes in the guitar and then putting other side of the guitar 


all of the parts inside became quite a tedious sila a aka d a 
task,” he recalls. “I originally had everything a chord 
on prototyping boards, but components kept 
coming unplugged. Because of this I decided to 
solder everything properly on PCB boards, which 
improved everything here." 

All the electronic components, including 
a Raspberry Pi, are secreted inside the body 
of the guitar. “There’s actually a lot of stuff 
in there, but none of itis that heavy other 
than the portable battery pack." It doesn't 
seem to have an adverse effect on the sound 
quality either: "Initially I thought it was going 
to be a big problem, but when comparing it 
against my other guitar, there isn't really 
much difference." 


A The Pi and other 
components, 
including an eight- 
channel relay for 
the solenoids in the 
Braille reader, are 
stuffed inside the 
body of the guitar 


< Extensive controls 
and features 
include selection 
buttons, a mic and 
speaker, along with a 
segment display and 

LCD screen 


Turn it up 

While Joe is happy with the project, he's planning 
a few tweaks. “Pd like to add an amplifier and 
volume control to improve the functionality Quick FACTS 
of the speaker. Another thing I'd like to add is 
real guitar tuning functionality - so something 

in the software that will analyse the note played 
and let the user know if the string needs to be 
tuned higher or lower. This isn't yet possible 

with the Google Assistant, but would be a useful 
feature for users who might not have experience 
with tuning a guitar. I could also make use of the 
screen to instruct the user here and cater for the 
different accessibility needs." 

If you'd like to have a go at creating a similar 
project, Joe has open-sourced most of what is 
needed to build the guitar, apart from the program 
that runs on the Raspberry Pi which drives the 
user interface and GPIO for the components. 

*The wiring diagram and conversational bot are 
open-source, so someone could build it if they 
wanted to.” 

Following feedback from users, Joe plans to 
iterate on the design to create more smart guitars. 
Since this project has struck a chord with us, 
that's music to our ears! 7 


» Chord Assist has 
been nominated for 
a Webby award 


The screen, Braille 

reader, and speaker 
can each be turned 
on/off individually 


v 


There's a button 
to quickly repeat 
the last returned 
voice response 


v 


v 


A four-digit 
segment display 
shows available 
chords.. 


Buttons below it 
can be used to 
select a chord, 
instead of speaking 


v 
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The speaker plays audio 
telling you if supplies 
are running low 


The Intelli- T 
Raspberry P1 
Sensor Alarm 


Never knowingly run out of tea-bags again with 
this ingenious system. Nicola King investigates... 
with a cuppa at her side, of course! 


I 


of no tea-bags in the house, Robin Mitchell 

was inspired to contrive an invention that 
would eliminate the possibility of that scenario ever 
happening again, and the Intelli-T Raspberry Pi 
Sensor Alarm was born. As he explains, “One of the 
biggest problems that faces many British homes, as 
well as my own, is having a stable supply of tea... an 


F aced with the, almost unthinkable, problem 


Robin 
Mitchell 


M One of the biggest problems that faces 
many British homes, as well as my own, 
is having a stable supply of tea Ø 


Based in the UK, 
when not making 
and creating, 

Robin owns a 

small electronics 
business, and he 
also contributes to 
various websites 
with blog posts and 


issue with knowing how many tea-bags are available 
in the house. Hence, an intelligent tea-bag container 


j was needed!" 
how-to tutorials. I : 
. reflection, it would have been better to use a much 
magpi.cc/FfbnNF Simplici-tea smaller weight sensor, so that the weight of the 
Simple in its design, the project consists of onlya individual tea-bags is larger with respect to the 
few elements, as Robin tells us: “The first element minimum weight that the sensor can register (this 
is the weight sensor itself, which weighs the would improve the accuracy).” 


tea-bag container. This weight sensor is connected 
to a standard HX711 ADC, which is then read by an Brewing ideas 
Arduino. The Arduino then sends the weight data to Undeterred, Robin successfully completed his 
the Raspberry Pi, which can keep track of how many tea-bag detection system, and feels that this 
bags there are, and play interesting facts about tea kind of weight-sensing system could easily 
when a tea-bag is removed.” be used in other projects. “One area that 

Clever, but as with many inventions, not entirely could benefit from a similar system would be 
straightforward to construct, with the weight sensor industrial systems that need to count parts such 


providing the main issue, as Robin elaborates: “The 
problem with weight sensors is that they require 
plenty of fine-tuning and can be very noisy. While 
this is not a problem for heavier items, trying 

to accurately weigh tea-bags is a nightmare. On 
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as resistors, transistors, capacitors, and even 
potentiometers. Of course, part counting can 
also be useful for the everyday hobbyist who 
wants to keep check of their component stock, 
and someone like myself who stocks many 
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Areed switch on the lid detects i Quick FACTS 
when the tea caddy is opened, A 1 s. 

triggering the weight sensor i. 4 > The Pi code was 
" written in Python 


» Areed switch 
senses the 
lid opening 


a tw 


meros kasting ka 


À 
H 1, 8 


v 


The weight sensor 
needs to be 
calibrated first 


TRIN 

ooooo | 0 i > It plays audio 

N LIE IL] =i responses, 

M including eight 
tea facts 


v 


His other Pi projects 
include a savings 
machine and a 
home automated 
butler system! 


80 TEA BAGS 


A load sensor is used to 
weigh the tea caddy and 
its contents 


thousands of parts needs to keep an accurate 
check on inventory regularly (as I own a small 
electronics business).” 
There certainly appears to be some scope here 
for future projects but, as for tea-bag detection, 
Robin thinks he has taken that particular piece of 
work as far as he can. "The project was great fun, 
but since I no longer drink bagged tea (lemon tea 
rules!), I don't have a use for it any more.” 
Not that Robin is short of ideas for other 
projects. *Each day of my life is all about creating 
projects around many platforms, with the 
Raspberry Pi included. Only recently, I designed 
a simple IoT monitoring station for an IoT sensor 
that can be affixed to a drill, and the vibration data 
streamed to the Raspberry Pi via a local network. 


: ae : A The electronics behind the 
AllIcan say is that the Raspberry Piis a fantastic Intelli-T: a Raspberry Pi 3, 
platform for prototyping and project building!” WI Arduino Uno, and HX711 ADC 
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 ongratulations, you've bought a Raspberry 
Pi. You've hooked it up and had a go, but 
reached the limit of the interesting stuff on 
the desktop. You're ready for some hardware, to 
make your Pi do something interesting! 

The Pi is a good place to start with your own 
hardware projects, with the perfect combination of 
interfaces alongside the best documentation and 
support community in the field. Most computers 
don't sit on desks; instead, they take measurements 
and control machines. So, by bringing your Pi into 
the things you make, you're taking the first step 
into the exciting world of embedded computing. 


FEATURE | MagPi Wasa 


You may have seen some really cool Raspber 

Pi hardware projects, but when you take a a 

ba they seem impossibly complex. It’s all rather 
aunting, but fear not: it’s simpler than it looks 


Finally, with the inputs read and the decisio 
made by the software, the computer must do ` 
something. For that it needs outputs, things that 
transfer from the software to the rea kaw Thise 


The functions of 
any embedded i j 
ne S ee project can be as simple asan LED; abit more d i 
Bee measures such as a servo in a robot; l B Ë 
o think what it will do with i nen Kr x E 
those measurements, then it makes A the mechanism of a 3D printer. Agai eran Ei 
happen with the result. If you see AMANTE even need to be physical - for e (eee fa š 
like to mak we a project you’d softwa a wa du | | 
ma e, then splitting it into those three parts a you dede > - nien | 
makes it much simpler to understand b N A ee | 
zd | : eitj i | 
ë aking a look at those inputs, just how does a Th ee las al problem | nis kanya | 
5 omputer measure something? The answer is that pa ue plenty of es rapletêjprojêct aa 0 | teed broadooar ! 
it asks a sensor connected to one of its input nd there, in the pages of The MagPi or on the web S I ana pa 1 
T | ia a th suben and fiddly resi ! 
as dá Y I y resistors 
T s the reading. That sensor can be as simple what caus up le meme | 
| ee 5 S at to make or how to make it. Instead, we'll t lo i | 
emperature sensor; or very complex, for exampl to help you with your own ideas, by shdwing d L | 
the Pi Came > mple some of the i | a | you could attach 
physical h = Module. It doesn’t even need to be you’ll need en El | 
ardware - for instance, a feed of the DO Gu E i | 
emperature in Miami from the internet or th 
impetu im A _ I and coded these 
: m the Pi’s clock could both be pina bur man E | 
arat tih ient 40 pins, but pansion header ont I = er-controlled | 
" E Many more than 40 gd has i stairlights in under l 
x the software for the thinking stage wani Ke em | 
x | | colo l 
Po ede the code you write, can be extremely dos nn ! 
rve i ioni | 
HL e ry complex, but its function is always N | 
e information from the inputs and apply das x 
a set of conditions to it to decide what to do. As | T | 
examples, a piece of software could send an output — | | 
to 
à an LED only when both of two buttons have been 
ressed, or it could make the decision on when 


o move a robot based upon whether a proximity 
sensor detects any obstacles. 


nsion header 


The GPIO expa 


many more possibilities 


The Pi's 40-way GPIO expansion header has 
h your projects, we'll explain what it does 


than it has pins. Now, to help you use it wit 


The GPIOs, on or off m Life beyond the GPIO H Pi care 
All of those active GPIO pins 


The simplest way into your Sometimes you need more than 
is possible with a GPIO pin; the header lead directly into the CPU on your Pi, 
and thus if you apply too much voltage 


has secondary functions that may 
or current to them, you can damage it. 


output’. These are on-off pins that you help. SPI, 1?C, and 1-wire are high- 
They normally work at 3.3V and 10 mA, 


can either use as outputs or inputs, speed interfaces for some peripheral 

chips that extend the capabilities of so precautions, such as using a resistor 
the Pi. You might use them with an with an LED, should be taken. To use 
LCD display, a temperature sensor, or your Pi with a 5 V device such as an 

an analogue-to-digital converter. The Arduino, special HATs are available to 


Sense HATisan example of multiple protect your Pi and give you a buffered 
chips at once connected in this way. set of GPIOs to safely work with. 


r 

1 

1 

1 

' 

' 

' 

' 

' 

' 

' 

ı Piare the 26 so-called GPIO ports, 
standing for ‘general-purpose input/ 
1 
' 
' 
' 
' 
' 
' 
' 
' 
' 
' 


sending or receiving logic 1 or logic 

o voltage levels. Use one anywhere 

a simple ON or OFF condition is 
required, for example to turn on or off 
an LED, or to sense whether a button 


has been pressed. 
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MAKER TIP 


Alex Eames 


“Start ‘small and 
simple’ and you'll 
be amazed at how 
quickly you can 
grow a project as 
you keep adding 
more and more bits 
to it and trying out 
and combining new 
ideas, learning and 
Googling as you go. 
You don't usually 
have to completely 
reinvent the wheel 
to implement 

your idea.” 


raspi.tv 


The oscilloscope 

Y is optional, but in 
front of it are the 
essentials of a PI 
hardwa 


re workbench 


o connect your Pi to any external 

components, you'll need to pick up a 

few basic skills and have some tools. 
Don't worry, though: there's nothing difficult or 
expensive involved, and once you have them you're 
all kitted out for further work. You're at the start 
of the road to becoming an electronic engineer, 
and the techniques you'd use to wire something 
to a Pi are exactly the same as those used by the 
professionals, simply on a smaller scale. 


Start with your bench 

Your workspace, or your bench, is where 
you do your Pi experimenting and other electronic 
work. An ideal bench is well lit by a powerful 
amp, and has a clear space surrounded by easy- 
to-reach racks for components and equipment, 
with plenty of power sockets. 
Organising your bench is important: there will 
be tiny screws and parts which can easily get lost. 
Soldering can damage surfaces with heat, and 
tools can mark surfaces when not used carefully. 
Look for a surface protector, ideally a silicone 
anti-static one intended for electronic use. Some 
form of small parts organiser is advisable. 
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v A basic soldering iron, stand 
p cleaner, and solder. All you 
should need to make your 


projects more permanent 


Benchtop tools 

The standard toolkit starts at a surprisingly 
simple level with hand tools. A set of precision 
screwdrivers, a small pair of pliers, a wire stripper, 
a craft knife, and some Helping Hands are things 
you'll find handy far beyond your work with the Pi. 

Anybody working with electronic hardware 

needs, at some point, to check for a voltage or a 
lack of it. A multimeter is the instrument for this 
task, and can be had for a surprisingly low cost. 
A typical inexpensive multimeter will feature a 
digital display and a rotary selector switch for its 
various voltage, current, and resistance ranges. 


Not just for your loaf 

At first, your circuits won't be permanent 
- you'll be exploring the many possibilities your Pi 
can offer. A breadboard is a convenient way to easily 
make circuits that are straightforward to dismantle 
or reconfigure. Available in a variety of sizes, a 
breadboard is a plastic block with a set of lines of 
spring contacts mounted under a grid of holes in 
its top. Circuits are made by inserting component 
leads through the holes, with connections via the 
lines of spring contacts underneath. 

A breadboard needs connections beyond its 

components, so you may also need a set of jumper 
leads. Get some that have socket-to- pin leads as 
well as just pin-to-pin: you can use the socket ends 
to connect to your Pi. 


Soldering for a 

permanent connection 

Breadboards are great for experimenting, but 

not for the long term. Soldering permanently 
joins conductors with molten metal for a good 
connection. It requires care, but will serve you well 
in any electronic work. 

The soldering iron is like a pencil whose tip 
reaches 350°C to melt the bilder A soldering iron 
can deliver nasty burtns, aa should take care. 
Buya stand with your iron, and some means of tip 
cleaning, such as a bundle of brass shavings or a 
wettable sponge. 

Cheap soldering irons will suffice, but buy a 
temperature-controlled-one if you can afford it. 


M To connect your Pi to any external | 
components, you'll need to pick up a few 
basic skills and have some tools 0 


Tanya Fish 


"Remember that 
the community 
shares code 
examples widely 

- don't be afraid 

to modify existing 
code, with credit to 
the original author 


of course!" 


tanyafish.com 


You don't have to make 
everything yourself | 
It's important to note that some things are 
difficult to build, and there's no shame in getting 
them from somebody else. If you need-something 
3D- printed, for instance; your local hackspace may 
be able to-help. A commercial motor controller 
HAT will be far more reliable than ahome-made 
one, and an off-the-shelf robot frame will save 
you huge amounts of work, Many sensors and 
semiconductor parts are availablein so-called 
breakout boards, in which the part is mounted on 
a small PCB whose connections are broug to 
breadboard-friendly pins. 
It’s,not cheating to buy something off-the- 

shelf; if it helps your project to work! 


Where to find all this stuff 

Most of what you need for an electronics 
workbench can be bought from the Raspberry 
Pi store in Cambridge (magpi.cc/retail-store). 
Elsewhere, there's a huge range of online 
suppliers to ship you what you need. Take a 
look at the websites of the usual Raspberry Pi 
suppliers, ask for recommendations at your 
local Raspberry Jam, and watch out for stalls at 
Raspberry Pi events. Suppliers even offer them as 
kits of tools, or of soldering equipment. 
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Archie Roques 


“Make sure to look at. all 
the available interfaces 
the Pi has when using 
one in a hardware 
project. Often, the one 
1 that first comes to mind isn't 
ı the easiest in the long run!" 


We’vetalked about the physical 
part of building a Pi hardware 
Project, but what about Software? 
Fortunately, that's made as easy 
as possible through Python, 

the software language that's 

the starting point for Pi coders. 


that's shipped as part of the default 
Raspbian distribution. Its simple 
Interface takes you Straight to the 
hardware with a minimum of other 
Code required, and it has built-in 
Support fora huge tarray of sensors 
and Output devices. For more 
information on GPIO Zero, we have 
a tutorial on Page 34. 
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This Pi laptop looks. good dudo | 


was made with penu A 
| \ 


; | There are many Pilaptop er se 
. — „ Web, but a lot of them are made using ` = 
expensive techniques such as laser cutting, 

which not all readers will have. We’ve therefore | 
picked one made using common materials and— 
everyday hand and power tools. Chitlange Sahas’ s | 
laptop is like many others in using a laptop screen. "e 
with an HDMI converter board, and has two power | 
banks to keep both display and Pi happy. A small 
USB keyboard completes the build, giving it a _ 
conventional clamshell form M we 


Brian Corteil 


“Even the largest project can 
be broken down into small 
parts to work on. Watch out for 
feature creep, and be prepared 
to drop features to meet your target. 
It's not bad to fail: failing makes you a 
better maker when you learn from 
your errors." 


core-tec.co.uk 
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Driving servos with 


a Pi: the MeArm 


Servos give this robot arm life 


magpi.cc/siviiT 


4 D 1 You will want your projects to have moving 
L — 4 parts, and the humble servo provides an 
inexpensive and straightforward way to achieve 
this. The MeArm is a popular robotics project 

for which you can buy kits or try making from 
scratch. All the motor control electronics are 
taken care of by the servo manufacturer, so all you 
need to do is apply some power and PWM control 
from your Raspberry Pi. The exciting world of 
robotics awaits you! 


M All the motor control 
electronics are taken 
care of by the servo 
manufacturer Ej 


Driving NeoPixels 
with a Raspberry Pi 


Pretty lights, a staple of so 
many maker projects 


magpi.cc/QXDsfQ 


4 ~ 7 The WS2812, sometimes called a NeoPixel, 
L — „ is an addressable and cascadable LED 

chip that can display any colour of the rainbow 
under software control. You will see them on 

a huge number of projects, and knowing how 

to drive them is a useful tool in any maker’s 
arsenal. Adafruit has a tutorial and some software 
to enable a Pi to drive NeoPixels, with a host of 
different hardware configuration options for 
diverse applications. WS2812s are available ona 
flexible tape, or in a variety of PCB configurations 
such as rings and sewable boards. 
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A retro console 
reborn with a Pi 


This Nintendo GameCube was 
destined for the dump, until a 
Pi rescued it 


magpi.cc/tztAHx 


% = ` RetroPie is a well-supported project 

. — 4 that turns your Pi into a powerful 
multi-platform retro gaming machine. Liam 
McLoughlin had a Nintendo GameCube that 

no longer worked, so turned it into the perfect 
RetroPie console with the help of a Raspberry Pi, 
a Dremel, and copious quantities of hot glue. In 
a particularly neat touch, he was able to reuse 
the original GameCube power supply. People 
have built RetroPie machines in all sorts of 
incarnations, from handheld consoles with LCD 
screens, through retro consoles like this one, to 
full-size arcade cabinets with CRT monitors. 


Rachel 
'Konichiwakitty' Wong 


“Join the maker community 

on Twitter. It is easier to ask for 

help, especially if you are self- 
1 taught and don't know the correct F 
j terms, to take a photo of the problem and I 
| Share it with hashtag #makershelp or tag any of | 
I the customer services such as eRaspberry. Pi" | 
I I 
1 I 


MAKER TIP 


magpi.cc/YxPqFw 
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b Bere with a Raspberry Pi 


eum \Brian asney’s weather station takes a 

. — a Pi Zero and turns it into a fully-featured 
weather station and data logger, with wind, 
‘ain, temperature, humidity, and pressure 
ensors, The Zero is mounted in a waterproof 
box along with aset of lithium-ion batteries, 
and topped with a solar panel. On winter days, 
there isn't quite enough sun to keep it going all 
night; so he plans to fit a larger battery. Hisown 
YADL software completes the-project, providing 
a browser interface With plenty of graphs to show 


he ne as they happen. 
TIMES 


71 A fully-featured weather 
station with wind, rain, 
temperature, humidity, and 


ar | res 3 : 
ERE 


| => 
This Raspberry Pi heater will 
track your every move | 
| magpi.cc/uDbdem 

|^ The Raspberry Pi Camera Module can do so 
1 — . much more than capture snaps or videos. — - 
Matthias Wandel kept warm in his workshop by 

using his, along with motion detection software, 

to keep an infrared heater always pointing at 

him. The heater sits atop a rotating platform 

driven by a stepper motor from the Pi through 

a stepper controller board, and moves to point 
automatically at him. The software is his own 


Imgcomp package, though a similar result could 
be achieved with the popular OpenCV. 


\ 
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Ben 
Nuttall 


Ben is the creator 
of GPIO Zero and 
piwheels, and is 
the Raspberry 

Pi Foundation's 
resident 

Python expert. 


@ben_nuttall 


Electronics 
with GPIO Zero 1.5 


Take an off-the-shelf battery-powered door-bell and hack it to add new 
features, add a camera, and use a tonal buzzer to create your own jingle 


includes support for making tunes with 
buzzers, so it’s the perfect opportunity to 
hack yourself a new door-bell jingle. 


T he GPIO Zero library for Python now 


Upgrade GPIO Zero 

GPIO Zero v1.5 just came out! It’s got some 
new features we’re going to use in this tutorial, 
so make sure you upgrade! Check that your Pi’s 
online, open a Terminal, and type: 


sudo apt update 
sudo apt install python3-gpiozero 


| You'll Need 


» Raspberry Pi 
Zero or 3A+ 
magpi.cc/wHwfNX 


> Raspberry Pi 
Camera Module 
magpi.cc/jbKzbf 


» Jam HAT, or buzzer 
and transistor 
magpi.cc/jMxZCU 


» Wilko Portable 
Standard Door 
Chime 
magpi.cc/pfUhqo 


P A£10 Wilko door-bell 
comes with a remote 
battery-powered 
chime unit 


That will bring in the latest GPIO Zero, and will 
install python3-colorzero too, as that’s a new 
dependency of GPIO Zero. 

You can check what version you have by typing: 


apt-cache policy python3-gpiozero 


This will also tell you if there's a new 
version available. 
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Tonal buzzer 

One of the new device classes in GPIO Zero 
is TonalBuzzer, which allows you to play particular 
tones by setting the PWM frequency. You can play 
a sequence of notes to make a tune, or you can 
make interesting sound effects like a police siren 
by cycling through frequency ranges at different 
speeds. It's nothing like the quality you'd get 
from a speaker, but it's certainly possible to make 
discernible tones and jingles. There's a tonal buzzer 
on ModMyPi's new Jam HAT, or you can use a 
normal buzzer like the one in the CamJam kit, but 
you'll get better results if you use a transistor to 
apply 5V to the buzzer, like they do on the Jam HAT. 


Playing a tune 

First of all, open up a Python shell or the 
REPL in your favourite Python editor and import 
the stuff you'll need, then create a TonalBuzzer 
object on the GPIO pin it's connected to: 


from gpiozero import TonalBuzzer 
from gpiozero.tones import Tone 

from gpiozero.tools import sin values 
from time import sleep 


tb = TonalBuzzer(20) 
Now try playing a single note: 

tb.play(60) 
That will play MIDI note 60 (middle C). You'll get 
an ‘ambiguous tone’ warning, but don't worry: 
that's just because the Tone interface allows you to 


use MIDI notes, frequencies, or musical notation. 
To be more explicit, you would generally use 


A Take a look inside 


Tone(midi=6@) rather than just 60 or Tone(6@). Type 
tb.stop() to stop it playing the note. Type Tone(60) 
into the REPL to see its three representations: 


<Tone note='C4' midi=60 frequency=261.63Hz> 
Try playing a scale: 


for note in 'C4 D4 E4 F4 G4 A4 B4 C5'. 
split(): 
tone - Tone(note) 
print(repr(tone)) 
tb.play(tone) 
sleep(0.3) 
tb.stop() 


And finally, for effect, let's try that siren noise we 
were telling you about: 


tb.source - sin values() 
Simply passing in a series of values from the sine 
wave will make the buzzer continuously alter its 
frequency from one octave down to one octave up, 
achieving a siren effect. To speed it up or slow it 
down, alter the buzzer's source delay (default 0.1): 
tb.source delay - 0.01 


OL! 


tb.source_delay = 8.5 


Keyboard control 

Now install the inputs library, which is a 
great utility for reading (amongst other things) key 
presses in real-time. Open a Terminal and type: 
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m Create a dictionary mapping each of the 
characters on the middle row of your 


keyboard to a note Ø 


sudo pip3 install inputs 


Return to the Python shell, import get. key, and 
create a dictionary mapping each of the characters 
on the middle row of your keyboard to a note: 


from inputs import get key 


keys = ('A': 'CA', 'S': 'DA', 'D': 'E4', 
'F': 'F4', 
'G': 'G4', 'H': 'A4', 'J': 'B4', 


Add a loop to look for these key presses and play 
notes when they’re pressed: 


while True: 
events = get_key() 
for event in events: 
if event.ev_type == 'Key' and 
event.code[-1] in 'ASDFGHJK': 
if event.state: 
tb.play(keys[event.code[-1]]) 
else: 
tb.stop() 


Now press any of the keys A to K and it'll play a 
note. You've turned your computer keyboard into a 
musical keyboard! Try playing a tune. 


A Connecting the 


door-bell wiring to 
the Pi's GPIO pins 


TopTip è 


Programming 
paradigms 


Try out different 
programming 
styles - GPIO Zero 
provides different 
approaches 
including 
procedural, 
blocking, and 
callbacks. 

Read the 
documentation 
for a better 
understanding. 
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TopTip ó 


Solder on 


Be cautious when 
soldering - you 
don't want to 
accidentally 
desolder some 
other useful 
parts of the door- 
bell's PCB. Take 
your time 


Your own door-bell jingle 

We worked out the tune for the Pink 
Panther theme. Use this, or feel free to take this 
opportunity to create your own, using MIDI notes 
or musical notation. Or you could opt for the police 
siren effect, but that might be more alarming than 
necessary when it's just an Amazon order delivery. 

For Pink Panther, here's a function to take a list of 

notes and durations and play them in sequence. 


def play(tune): 
for note, duration in tune: 
print(note) 
tb.play(note) 
sleep(float(duration)) 
tb.stop() 


tune = [('C#4', 0.2), ('D4', 0.2), (None, 0.2), 
('EbA', 0.2), ('E4', 0.2), (None, 0.6), 
('F#4', 0.2), ('GA', 0.2), (None, 0.6), 
("Eb4', 0.2), ('E4', 0.2), (None, 0.2), 
('F#4', 0.2), ('G4', 0.2), (None, 0.2), 
('C4', 0.2), ('B4', 0.2), (None, 0.2), 
('F#4', 0.2), ('G4', 0.2), (None, 0.2), 
('B4', 0.2), ('Bb4', 0.5), (None, 0.6), 
('M', 0.2), ('G4', 0.2), ('EA', 0.2), 
('DA', 0.2), ('E4', 0.2)] 


play(tune) 


07 Hacking the door-bell 

Note: These instructions are for battery- 
powered door-bells only. DO NOT use a mains- 
powered door-bell. 

Open up the door-bell chime by unscrewing the 
case to reveal the PCB inside. You'll notice a white 
wire with one end unattached (that's the radio 
receiver), red and black wires going to the battery 
pack, more white wires going to the speaker, and 
another pair of red and black wires going to the 
LED on the front of the case. When the door-bell is 
pressed and the signal is received, the LED comes 
on and the chime makes its sound. 

Optionally, you can choose to rewire the power 
to the receiver so that it comes from the Pi instead 
of batteries. Since it takes two AA batteries (1.5 V 
each), it requires ~3V. You can power it from the 
Pi by connecting the black wire to GND and the red 
wire to 3V3 (we soldered outs straight to a 3V3 pin 
hole on a Pi Zero). And of course, if you prefer your 
own jingle, you can disconnect the speaker. 
ext, desolder the wires going to the LED and 
connect them to the Pi instead: red to a GPIO pin, 
and black to GND (you can cut jumper wires in 
half and solder them to the wires, and connect the 
female end of the jumper wire to the Pi pins, or 
even solder the ends directly to the Pi Zero pin holes 
like we did). It's best to test before you commit to 
soldering things together, so take it steady. 


Camera test 
The easiest way to initially test the camera 
is to open a Terminal and type: 


raspistill -k 


This opens the camera preview until you kill it with 
CTRL+C. Now back to Python; write some simple 
code to trigger capturing a photo in a loop: 


from picamera import PiCamera 
from datetime import datetime 


camera - PiCamera() 


while True: 
input("Press Enter to capture") 
dt = datetime.now().isoformat() 
camera.capture('/home/pi/{}.jpg' .format(dt)) 


This will take a picture when ENTER is pressed, 
and save it with the current timestamp. 
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Testing the door-bell 

Did it work? Let's see. In theory, you should 
be able to detect a signal on the GPIO pin you wired 
the door-bell to, the same way you'd detect a button 
being pressed. So, back to Python and GPIO Zero: 


from gpiozero import Button 
doorbell - Button(21) 


button.wait for press() 
print("Pressed") 
button.wait for release() 
print("Released") 


Now press the door-bell, and you should see the 
message ‘pressed’ when the door-bell is pressed, 
and ‘released’ once the chime stops playing. If it 
doesn't seem to be working, you'll need to check 
your wiring. You might need to add a resistor to 
make sure you detect the change in voltage when 
the button is pressed. We found that if we wired 
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DOWNLOAD 


doorbell.py THE FULL CODE: 


A Connecting the door-bell wiring to the Pi's GPIO pins 


ours directly to the IC (red square on the picture), 
the resistor in between would take effect. 


Putting it all together 

Now let’s put together all the components: 
the door-bell, the jingle, and the camera. If you 
want to dedicate a Pi to live in this project, it 
should probably be a Pi Zero W or 3A+. With a Pi 
Zero, you can solder the components directly to 
the GPIO pin holes. You'll have easier access to 
the GPIO pins with the 3A* or another full(er)- 
size Pi, but it will take up more space, which may 
be at a premium if you're trying to fit it all inside a 
small container (especially the original door-bell 
receiver enclosure). 

Connect your Jam HAT or your buzzer, and 
solder your door-bell receiver wires and connect 
them to the Pi's GPIO pins. Connect the camera 
and find a way to mount it in place. If you've got 
clear glass on your front door, you can stick the 
Pi behind or beside the door and have the camera 
facing out. Make sure all your connections are 
strong, and the enclosure is keeping everything in 
place, then connect the Pi's power supply, making 
sure it won't get pulled out. Attach the door-bell 
to the front door, and put your code together to 
give it a whirl! See the completed code in the 
doorbell.py listing. 


Run at boot 

The important finishing touch is to have 
your program run at boot. There are a good few 
ways of doing this, and if you want to find out some 
alternatives, just ask someone how they tend to 
do it - chances are you'll get a different response 
each time. Your author's preference for basic script 
launching like this is cron, either using crontab 
if you know how, or we'd recommend installing 
GNOME Schedule, a cron GUI: 


sudo apt install gnome-schedule 


» Language: Python 3 


001. from gpiozero import TonalBuzzer, Button 
002. from picamera import PiCamera 

003. from datetime import datetime 

004. 

005. buzzer = TonalBuzzer(20) 

096. doorbell = Button(21) 

097. camera = PiCamera() 


088. 

089. def play(tune): 

010. for note, duration in tune: 

011. buzzer.play(note) 

012. sleep(float(duration)) 

013. buzzer.stop() 

014. 

015. pink panther - [ 

016. ('c#4', 0.2), ('D4', 0.2), (None, 0.2), 
017. ('Eb4', 0.2), ('E4', 0.2), (None, 0.6), 
018. ('F#4', 0.2), ('G4', 0.2), (None, 0.6), 
019. ('Eb4', 0.2), ('E4', 0.2), (None, 0.2), 
020. ('F#4', 0.2), ('G4', 0.2), (None, 0.2), 
021. ('cA', 0.2), ('BA', 0.2), (None, 0.2), 
022. ('F#4', 0.2), ('G4', 0.2), (None, 0.2), 
023. ('B4', 0.2), ('Bb4', 0.5), (None, 0.6), 
024. ('A4', 0.2), ('G4', 0.2), ('EA', 0.2), 
025. ('D4', 0.2), ('E4', 0.2) 

026. ] 

027. 

028. while True: 

029. doorbell.wait_for_press() 

030. dt = datetime.now().isoformat() 

031. camera.capture(' /home/pi/().jpg'.format(dt)) 
032. play(pink panther) 


Just add a new recurrent task that launches at 
reboot. The task should look something like this: 


python3 /home/pi/doorbell.py & 


Make it your own 

So far we've added some basic features - a 
custom jingle and camera - but there's much more 
you could do. If you have smart light-bulbs, you 
could have it flash the house lights to give a visual 
indication when the door-bell rings, even when 
you have music playing. You could have it email, 
text, or tweet you. How about a push notification to 
your phone? If you're feeling ambitious, you could 
try to identify the door knocker and decide who to 
let in! The world is your door-bell. WI 
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Make a retro console 


with RetroPie 


[ You'll Need 


v 


v 


v 


v 


v 


v 


Lucy 
Hattersley 


Lucy is the editor 
of The MagPi. 

She likes retro 
gaming, building 
robots, coding, and 
making magazines 
and websites. 


magpi.cc 


Raspberry Pi 
2/3B/3B+ 


USB keyboard 
(for setup) 


Blank microSD card 
magpi.cc/ 
noobscard 


SD Memory Card 
Formatter 
magpi.cc/ 
sdcardformatter 


RetroPie image file 
retropie.org.uk/ 
download 


Blade Buster ROM 
magpi.cc/ 
bladebuster 


Discover classic gaming on the Raspberry Pi and play 


homebrew ROMS. By Lucy Hattersley 


games console is a fun project, and it’s one 
of the first things many a new Pi owner 
turns their hand to. 

The appeal is obvious. Retro games are fun, 
and from a programming perspective they’re 
a lot easier to understand than modern 3D 
powerhouses. The Raspberry Pi board’s small 
form factor, low power usage, HDMI connection, 
and wireless networking make it a perfect micro- 
console that can sit under your television. 

There are a bunch of different emulators around 
for Raspberry Pi. In this tutorial we’re going to 
look at RetroPie. 

RetroPie combines Raspbian, EmulationStation 
(emulationstation.org), and RetroArch 
(retroarch.com) into one handy image. With 
RetroPie you can emulate arcade games, as well as 
titles originally released on a host of 8-bit, 16-bit, 
and even 32- and 64-bit systems. You can hook 
up a joypad; we’ re going to use the Wireless USB 
Game Controller (magpi.cc/bbOgnE), but most 
other USB game controllers will work. 


T urning a Raspberry Pi device into a retro 


CONFIGURING 


GAMEPAD 1 


D-PAD UP 


PRESS ANYTHING 
«& D-PAD DOWN 

«&» D-PAD LEFT 

&» D-PAD RIGHT 

zz START 


A Configuring the gamepad maps its controls to the RetroPie 
games system so you can control the video game 
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You can also use Bluetooth to connect a controller 
from most video games consoles. RetroPie has an 
interface that will be very familiar to anyone who 
has used a modern games console and, because it is 
open-source, it is constantly being improved. 

You can look online for classic games, but we 
prefer homebrew and modern releases coded 
for classic systems. In this tutorial we will walk 
you through the process of setting up RetroPie, 
configuring a gamepad, and running a homebrew 
game called Blade Buster. 


Get your microSD card ready 

RetroPie is built on top of Raspbian (the 
operating system for Raspberry Pi). While it is 
possible to install RetroPie from the desktop 
interface, it's far easier to format a microSD 
card and copy a new RetroPie image to the blank 
card. This ensures all the settings are correct 
and makes setup much easier. Our favourite 
method of wiping microSD cards on a PC or 
Apple Mac is to use SD Memory Card Formatter 
(magpi.cc/sdcardformatter). 

Attach the microSD card to your Windows 

or Mac computer and open SD Card Formatter. 
Ensure the card is highlighted in the ‘Select card’ 
section, then click Format. 


Download RetroPie 

Download the RetroPie image from 
retropie.org.uk/download. It'll be downloaded as 
a gzip file; the best way to expand this on Windows 
is using 7-Zip (7-zip.org). With 7-Zip installed, 
right-click the retropie-4.4-rpi2 rpi3.img.gz file 
and choose 7-Zip » Extract here. Extract GZ files on 


We're using a wireless USB controller 
designed for retro gaming on the 
Raspberry Pi. You can also use controllers 
for modern video games consoles 


a Mac or Linux PC using gunzip -k <filename.gz> 
(the -k option keeps the original GZ file). 


gunzip -k retropie-4.4-rpi2_rpi3.img.gz 


Flash the image 

We’re going to use Etcher to copy the 
retropie-4.4-rpi2 rpi3.img file to our freshly 
formatted microSD card. 

Download Etcher from balena.io/etcher. 

Open Etcher and click Select Image, then choose 
the retropie-4.4-rpi2 rpi3.img image file and 
click Open. 

Etcher should have already located the microSD 
card; remove and replace it if you see a Select Drive 
button. Click ‘Flash!’ to copy the RetroPie image to 
the microSD card. 

See magpi.cc/etcher for more information on 
how to use Etcher to flash SD cards. 


Set up the Raspberry Pi 

Insert the flashed microSD card to your 
Raspberry Pi. Now attach the Raspberry Pi to a 
TV or monitor using the HDMI cable. Connect 
the USB dongle from the Wireless USB Game 
Controller (magpi.cc/gamepad) to the Raspberry 
Pi. Also attach a keyboard (you'll need this for the 
setup process). 


The heart of our games 
console is a Raspberry 
Pi 3B*. With a fast CPU 
and plenty of RAM, our 
retro game plays fluidly 
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TM RetroPie has an interface that will be 
very familiar to anyone who has used a 


modern games console Ej 


Insert the batteries in the Wireless USB Game 
Controller and set the power switch (on the 
back of the device) to ‘On’. Once everything 
is connected, attach a power supply to the 
Raspberry Pi. 

See magpi.cc/quickstart for more detailed 
information on setting up a Raspberry Pi. 


Configure the gamepad 

When RetroPie starts, you should 
see Welcome screen displaying the message 
*1 gamepad detected'. Press and hold one of 
the buttons on the pad and you will see the 
Configuring screen with a list of gamepad buttons 
and directions. 

Tap the D- pad (the four-way directional control 
pad on the far left) up on the controller and ‘HAT o 
UP' will appear. Now tap the D-pad down. 

Map the A, B, X, Y buttons to: 


A: red circle 
B: blue cross 
X: green triangle 
Y: purple square 


TopTip è 


Username and 
password 


If RetroPie asks 
you for the 
username and 
password during 
boot, the defaults 
are: pi and 
raspberry. 
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m AN INTRODUCTION | O 


PROGRAMMING 


Start creating 
your own GUIS 
with C & GTK 


AN INTRODUCTION TO 


Create simple command-line C programs 
& I Control flow with conditions and loops 
Handle variables, strings, and files 


P H () e RAMMI ING Design graphical user interface 


applications in C 
Handle user input with buttons and menus 


Simon Long Use advanced UI features such as data 


stores and dialogs 


£10 with 
worldwide delivery 


Buy online: magpi.cc/GUlbook 


Top Tip à 


Fix the borders 


These are caused by overscan. Choose RetroPie 
from EmulationStation and raspi-config. Now select 
Advanced Options > Overscan and select No on the 
‘Would you like to enable compensation for displays 
with overscan?' window. Choose OK and then Finish. 
Choose Yes on the Reboot Now window. When the 
system reboots, you will see the borders removed. 


wireless LAN network so you can access it when it's 


beneath your television. 

Head back into RetroPie from EmulationStation 
and down to the WiFi setting; choose ‘Connect to 
WiFi network’. 

The window will display a list of nearby wireless 
LAN networks. Choose your network and use the 


keyboard to enter the wireless LAN password. Press 


ENTER when you’re done. Choose the Exit option 
to return to the RetroPie interface. 


The Left and Right Shoulder buttons refer to the 
topmost buttons on the rear of the controller, 
while the Triggers are the larger lower buttons. 
Push the left and right analogue sticks in for the 
Left and Right Thumbs. Click OK when you’re done. 


Choose the network locale 
RetroPie boots into EmulationStation, 
which is your starter interface. It’s currently 
displaying just the one option, RetroPie, which is 
used to set up the emulation options. As you add 
games to RetroPie, other systems will appear 
in EmulationStation. 

With RetroPie selected, press the A button on 
the gamepad to open the configuration window. 
Use the D-pad to move down the options and 
select ‘WiFi’. You will see a warning message: 
‘You don't currently have your WiFi country 
set...’. Press the D-pad left to choose Yes and 
press A. 

The interface will open raspi-config. At this 
point, we find it handy to switch to the keyboard 
and use that instead. 

Choose ‘4 Localisation Options’, and press 
the right arrow key on the keyboard to highlight 
Select, then press ENTER. 

Now choose ‘4 Change Wi-fi Country’ and pick 
your country from the list. We used GB Britain 
(UK). Highlight ‘Ok’ and press ENTER to select it. 

Now move right twice to choose Finish and 
press ENTER. This will reboot the system. 


07 Connect to wireless LAN 
If you have a Raspberry Pi with an Ethernet 
connection, you can use an Ethernet cable to 
connect directly to your router/modem or network. 
More likely, you'll connect the Raspberry Pi toa 


Configuration tools 

Now choose RetroPie Setup and then 
Configuration Tools. Here, in the ‘Choose an option’ 
window, you'll find a range of useful tools. As we're 
using a USB gamepad, we don’t need the Bluetooth 
settings, but it’s worth noting they’re here. 

We want to turn on Samba so we can share files 
from our computer directly to RetroPie. Choose 
Samba and ‘Install RetroPie Samba shares’, then 
select OK. 

Now choose Cancel to back up to the ‘Choose 
an option’ window, and then Back to return to the 
RetroPie-Setup script. 


Run the setup script 

Choose ‘Update RetroPie-Setup script’ and 
press ENTER. After the script has updated, press 
ENTER again and you'll be back at the ‘Notice:’ 
window. Press ENTER and choose ‘Basic install’; 
press ENTER, choose Yes, and press ENTER again 
to begin the setup and run the configuration script. 

When the script has finished, choose ‘Perform a 

reboot’ and Yes. 
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WY Update the 
RetroPie-Setup 
script and configure 
it to activate 


Samba before 
running through 
the installation 
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P Blade Buster is a 


homebrew video 
game designed for 
NES systems. Here 
itis running on a 
Raspberry Pi 


TopTip ó 


Change the 
resolution 


Some games 
were designed 

for a much lower 
resolution, and 
scaling them up 
can look blocky 
on modern 
televisions. If you'd 
prefer to alter the 
resolution, choose 
'RetroPie setup: 
Open raspi-config, 
Advanced Options, 
and Resolution. 
Here you'll find 

a range of other 
resolution options 
to choose from. 
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Turn on Samba in Windows 
We're going to use Samba to copy a ROM 
file (a video game image) from our computer 
to RetroPie. 

Samba used to be installed by default in 
Windows, but it has recently become an optional 
installation. In Windows 10, click on the Search bar 
and type ‘Control Panel’. Click on Control Panel in 
the search results. Now click ‘Programs’ and ‘Turn 
Windows features on or off’. Scroll down to find 
‘SMB 1.0/CIFS File Sharing Support’ and click the 
‘+? expand icon to reveal its options. Place a check 
in the box marked ‘SMB 1.0/CIFS Client’. Click 
OK. This will enable Samba client support on your 
Windows 10 PC so it can access the Raspberry Pi. 

See magpi.cc/samba for more information on 
how Samba works. 


Get the game 

On your Windows PC or Mac, open a web 
browser, and visit magpi.cc/bladebuster. This is 
a homebrew video game designed by High Level 
Challenge for old NES systems. The developer’s 
website is in Japanese, but click ‘BLADE 
BUSTER Download’ to save the ROM file to your 
Downloads folder. 
Open a File Explorer (or Finder) window 
and locate the BB_20120301.zip file in your 
Downloads folder. Don’t unzip the file. Click on 
etwork and you'll see a RETROPIE share. Open 
it and locate the roms folder. Double-click roms 
and you'll see folders for many classic systems. 
Drag and drop the BB, 20120301.zip file and place 
it inside the nes folder. 
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Top Tip e 


Install Raspbian desktop 


RetroPie is built on top of the Raspbian operating 
system. You might be tempted to install RetroPie on 
top of the Raspbian with Desktop interface, but it's 
actually much easier to do it the other way around. 
Open RetroPie from EmulationStation and choose 
'RetroPie setup‘ Select ‘Configuration tools’ and 
'Raspbian tools’. Then choose ‘Install Pixel desktop 
environment’ and Yes. 

When it's finished, choose Quit and Restart 
EmulationStation. When restarted, EmulationStation 
will display a Ports option. Select it and choose 
Desktop to boot into the Raspbian desktop interface. 


Play the game 

Press the Start button on your gamepad 
to bring up the Main Menu. Choose Quit and 
Restart EmulationStation. You'll now see a 
Nintendo Entertainment System option with 
‘1 Games Available’ below it. Click it and you'll see 
BB. 201202301 - this is Blade Buster. Press A to start 
the game. Have fun shooting aliens. Press Start 
and Analog (or whatever you've set as your hotkey) 
together when you're finished; this will take you 
back to the game selection in EmulationStation. 

If you've been setting up RetroPie on your 
monitor, now is the time to move it across to your 
main television. The RetroPie console will boot 
automatically, connect to the network, and you can 
move ROM files over to it from your PC or Mac. You 
may notice at this point black borders around the 
screen; if so, see the ‘Fix the borders’ tip. 

Enjoy your gaming system! El 
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Raspberry P1 
Party popper launcher 


Need to fire a party popper and want to use code to pull the cord? What you need 
is an automated Raspberry Pi-powered Party Popper Launcher 


Mark 
Vanstone 


Educational 
software author 
from the nineties, 
author of the 
ArcVenture series, 
disappeared into 
the corporate 


software wasteland. 


Rescued by the 
Raspberry Pi! 


magpi.cc/YiZnxL 


@mindexplorers 


as a fireworks day workshop at the Milton 

Keynes Raspberry Jam, and then expanded 
for The Girls Day at Bletchley Park National 
Museum of Computing, covered in The MagPi #77 
(magpi.cc/77). The contraption enables us to 
remotely trigger a party popper (or poppers) with 
some simple Python code on our Raspberry Pi. 
We will first need to create a holder for our party 
popper, which we can design in a 3D modelling app 
and make with a 3D printer. Then, we will be firing 
it using the action of a low-cost servo. 


T he Party Popper idea was first presented 


Let’s start from the end 

Normally when introducing a tutorial, we 
would start with the basics and build up the idea, 
but in this case we need to see what we are aiming 
at, and then go back and put together each part 
of the build. This is how we approached designing 


Y Ifat first you don't succeed, keep 
printing! When developing a project 
from scratch, expect to have a few 
leftovers. This is a small sample 


the launcher: we decided what needed to happen 
and then worked on each part until it satisfied 
the requirement. So here is our impression of 
monkeys writing War and Peace, but we'll miss 
out the bits that didn't work. See the main image 
for the fully assembled launcher, and we'll go 
through the parts that it's made of. 


The holding device 

The launcher was designed using Blender 
and then 3D- printed. The source files are all 
available on GitHub (magpi.cc/YiZQxd) if you want 
to play with the design. First, let's look at a way 
of holding a party popper; it will need to be held 
straight with access to the firing string. We have a 
tube shape, with the inside being a width to mimic 
the popper shape, and a hole for the ‘handle’ to 
go though. The base of the tube is quite thick, to 
enable a post to be attached and be a firm fit. 


| You'll Need 


» Party poppers « 


> 3D modelling app aa 
blender.org 


» A3D printer ` 
magpi.cc/69 


> A heavy-duty 
digital servo 
magpi.cc/cVxSzg 


> 3 x male-to-female 
jumper leads 
magpi.cc/gqdtDy 
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The servo connects directly to the GPIO pins on the Raspberry 
Pi. One connects to ground, one to a 5V pin, and the signal lead 


connects to one of the pins that can be set for PWM 


The base 

The base could be printed out in one piece, 
but we found that laying the main part on its side 
made for a better construction for the servo to be 
mounted into. An interlocking cross-piece can 
then be printed to provide some stability to the 
base and stop it from falling over. When printing 
these pieces, you may need to adjust the wall 
widths so that they fit snugly together, but are 
not too tight. The base also has a hole, as with the 
holder part, so that a post can be attached. 


The post 

This is where it all comes together. The post 
is just a cylinder to attach the holder to the base. 
It does have a flat edge along its length, but that 
is only so that it sticks well to the 3D printer bed 
while it is printing. With this design, all four parts 
can be printed in a single print and then packed 
up into a small box, such as a plastic business 
card holder, with the other components for the 
build, which makes it ideal for workshops. It also 
provides an extra dimension of making for the 
workshop if no assembly instructions are provided. 


3D print designing 

So, we have covered what the 3D-printed 
parts are, but not how they were made. If you have 
not designed your own 3D parts before, it’s not 


difficult. You need a 3D modelling app; there are 
several free and paid-for options. Our favourite 

at the moment is Blender, because it’s free and 
we have followed its development for years; the 
makers have just made the beta of 2.8 available, 
and it rocks! Any modelling app that exports .obj 
or.3ds files or similar will be fine, as long as that is 
compatible with your 3D-printing software. 


Making the shapes 

If you are new to 3D modelling, try to keep 
the objects you make fairly simple to start with. 
This build is a good example of just using basic 
shapes. We have a few rectangles, a long cylinder, 
and short, wide cylinder. The way to make the 
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Party popper 
launcher printed 
with PLA filament. 
The launcher is 
printed in four parts: 
two for the base, one 
for the holder, anda 
post to join them 


TopTip & 


Blender 


3D modelling on 
the Raspberry Pi 
is a bit limited due 
to the hardware 
graphics support. 
You can install 
Blender with 
sudo apt-get 
install 
blender. There 
are also a few 
other options, 
such as 3D Slash. 


4 3D parts can be 
designed and 
redesigned in a 3D 
modelling app and 
then exported to 3D 
printing software. 
The printer then uses 
filament to build up 
the parts in layers 
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TopTip & 


Analogue 
servos 


You can use 
analogue servos 
for this, but 
because the GPIO 
is digital, you may 
find that working 
out the angles 

is more difficult, 
as the output 

will give some 
weird results. 


W Because the 


3D printer builds 
upwards, it's best 
to design parts so 
that there is no 
overhang to fill in, 
otherwise the print 
can get messy 


various holes in these shapes is to create a solid 
shape, then make a shape that you want to cut 
out. Then you can use a Boolean tool to subtract 
or cut out the second shape from the first. When 
you have completed your design, export the model 
in a suitable format. Try a few different ones, as 
the results may vary when you import into your 
3D printing software. 


07 3D printing 
Due to the way the parts are laid out, there 

are no significant overhangs, other than the small 
post holes, which means you shouldn’t need to 
clear away any supports or extra stuff. We used PLA 
filament on a very cheap, self-assembled printer. 
As a side note, if you want to find out all about 
how 3D printers work, get a DIY version and if you 
are feeling brave, a really cheap one with foreign 
instructions. By the end of the process of getting it 
working, you will know all about every component! 


Heavy-duty servos 

To start with, the obvious thing was to reach 
into the drawer and pull out whatever gizmos could 
be found that might be able to pull a party popper 
string. We tried a motor, but there were issues 
around needing gears, a suitable driver module, 
and mounting it securely. We then found one of 
the little blue 9g servos. It tried, it really did, but 
in the end we had to accept that it was not going 
to do the job. We found a lone HS-422 servo in the 
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A Figure 1 The jumper leads connect red to 5V, yellow/ 
orange to GPIO2 and brown/black to GND 


drawer, reworked the stand, and found a better 
result. Since then, we have found MG 996Rs are 
very similar in size and effect for this application. 


Plugging it in 

It is possible to wire the servo directly to 
the Raspberry Pi GPIO pins with three male-to- 
female jumper leads. Take a look at Figure 1 for 
where the wires go. A word of warning: although 
plugging in these electronics into these pins with 
the Pi running shouldn’t cause it damage, if you 
get it wrong, the outcome could be very different, 
so always power down the Pi before wiring up 

the GPIO pins, and check they are correct before 
switching back on. Once everything is hooked up, 
we can test the servo and get it moving. 


Testing 1, 2,3 

We can write a simple Python program to 
make the servo turn. See party_popper.py for 
the listing. We can write it using IDLE 3 or, if you 
prefer, another editor provided with Raspbian. 
We set up GPIO2 (which is physical pin 3) to PWM 
(pulse-width modulation) mode and start the 
output. We then have a function to change the 


A The setAngle() function will move the servo armature 
from its existing position to the new angle 


angle of the servo arm. We calculate the pwm value 
we need from the angle and change the duty cycle 
of the servo, wait for it to move, and then reset 
that value. By changing the value in the setAngle() 
call below this function, we will see the servo arm 
moving when we run the program. 


Using the angles 

It will depend how the armature of the servo 
is set, and probably a few other factors, that will 
define what angles are needed for the servo to move 
and pull the popper string far enough to set it off. If 
you mount the servo in the base so that the string 
can be attached to the end of the armature and 
as it turns, it pulls the string straight down (or as 
straight as possible), then you just need to find the 
angle at which the length of the string is shortest, 
and then the angle at the armature’s lowest. 


Fire in the hole! 

If everything is wired up correctly, your 
servo is set to the starting position and slotted 
into the base of the holder, the string is attached 
tightly to the armature, then we are ready to fire 
our party popper. Run the code with the setAngle() 
parameter set to the end angle we need, and ina 
couple of seconds the servo should spring into life, 
pulling down on the string with several kilograms 
of force. Before you know it, there should be a loud 
pop and a nice pile of streamers to clear up! WI 
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m In a couple of seconds the servo should 
spring into life, pulling down on the 
string with several kilograms of force Ej 


party_popper.py (eyes 


> Language: Python © magpi.cc/YiZQxd 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
088. 
009. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 


import RPi.GPIO as GPIO 
from time import sleep 


GPIO.setmode(GPIO.BOARD) 
GPIO.setup(3, GPIO.OUT) 
pwm-GPIO.PWM(3, 50) 
pwm.start(®) 


def setAngle(angle): 
duty=angle/18+2 
GPIO.output(3, True) 
pwm.ChangeDutyCycle(duty) 
sleep(1) 
GPIO.output(3, False) 
pwm.ChangeDutyCycle(®) 


setAngle(0) 


pwm.stop() 
GPIO.cleanup() 


TopTip & 


Workshop 
notes 


You can find the 
original workshop 
notes on the 
TechnovVisual 
Education site at: 
magpi.cc/yKUSQg 


< The party popper 
holder is a cylinder 
with a hole through 
the bottom and, on 
the underside, has a 
post hole to attach it 
to the base 
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Evans 


PJ is a writer, 
developer, and 
Milton Keynes 
Jam wrangler. He 
has terrible taste 
in movies. 


mrpjevans.com 


| You'll Need 


> Pi Camera Module 
magpi.cc/camera 


» Ahouseplant 


» Ruler or similar 
rectangular object 


» Contrasting, plain 
backdrop 


Use AI to build 
a plant monitor 


Measure the height and width of objects with your 
Raspberry Pi using only the Pi Camera Module and OpenCV 


wonder how high it is growing? Does using 

a ruler just sound like effort? Well, we have 
the tutorial for you. We’re going to measure a 
plant just using images taken with a Pi Camera 
Module. In the process, we'll introduce you to 
OpenCV, a powerful tool for image analysis and 
object recognition. By comparing your plant toa 
static object, OpenCV can be used to estimate its 
current height, all without touching. By adding 
data from other sensors, such as temperature or 
humidity, you too can build a smart plant. 


D o you know how tall your plant is? Do you 


Pick a spot 

We’re going to be using OpenCV (version 2) 
to measure our plant. To make sure our 
measurement is as accurate as possible, several 


6 8 S > | [ MT [ EAS ~) 


This is a static object that we 
have measured. By comparing 
with the plant's size, our code 
can estimate the height 
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factors need to be considered. The background 
must be plain and contrast against the plant; 
black or white is ideal. The area you are using 
must be very well lit when the image is taken. 
Finally, the camera must be 90 degrees to the 
plant, facing it directly. Any angles on any axis 
will cause poor measurement. If you are mounting 
the camera at a significant distance, you may want 
to consider a telephoto lens. 


Get a plant and object 

So how do we pull off this measuring 
trick? We can estimate the height of an object by 
comparing it with another object that is a fixed 
and known width and height. The image taken 
by the camera needs to include both objects. Get 
a rectangular object of a comparable size to your 


We waited ten minutes for a 
real plant to grow, but it didn't, 
so we used Lego instead 


Á Our testing rig. Note the camera is as close to 90 degrees 
to the plant as we could manage 


plant; we used a long piece of Lego. A metal ruler 
would also work well. Mount your object in front of 
the camera so it is on the left of the image and the 
same distance from the camera as your plant. 


plantbot.py 
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DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


© magpi.cc/omacNA 


Prepare your Pi 

The software used to analyse the image 
is the powerful OpenCV library and its Python 
bindings. You can use any current Pi for this 
project, but the higher-end 3B/3B+ will be much 
quicker at processing the image. OpenCV requires 
an X Window system in place, so we need to start 
with Raspbian Stretch including the Raspberry Pi 
Desktop. Once ready to go and on the network, 
make sure everything is up-to-date by running: 


sudo apt update && sudo apt -y upgrade 
Finally, install the camera, if you haven’t already, 


and enable it in Preferences > Raspberry Pi 
Configuration > Interfaces, then reboot. 


Install dependencies 

OpenCV is a bit trickier to install than most 
packages. It has lots of dependencies (additional 
software it ‘depends’ on) that are not installed 
alongside it. We also need a few other things to 
get OpenCV talking to the camera, so open up a 
Terminal window and run the following commands: 


sudo apt install python3-pip libatlas-base- 
dev libhdf5-100 libjasper1 libqtcore4 libqt4- 
test libqtgui4 


pip3 install imutils opencv-contrib-python 
picamera[array] 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 


010. 


011. 


012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 


028. 
029. 
030. 


031. 


032. 
033. 
034. 
035. 
036. 
037. 
038. 


import argparse 

import imutils.contours 

import cv2 

from picamera.array import PiRGBArray 
from picamera import PiCamera 

from time import sleep 


# Get our options 
parser = argparse.ArgumentParser(description=' Object 
height measurement’ ) 
parser.add_argument("-w", "--width", type=float, 
required=True, 
help= 
"width of the left-most object in the image") 
args = vars(parser.parse_args()) 


# Take a photo 

camera = PiCamera() 

rawCapture = PiRGBArray(camera) 
sleep(8.1) 

camera.capture(rawCapture, format="bgr") 
image = rawCapture.array 


# Cover to grayscale and blur 
greyscale = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY) 
greyscale = cv2.GaussianBlur(greyscale, (7, 7), ®) 


# Detect edges and close gaps 

canny_output = cv2.Canny(greyscale, 50, 100) 

canny_output = cv2.dilate(canny_output, None, 
iterations=1) 

canny_output = cv2.erode(canny_output, None, iterations=1) 


# Get the contours of the shapes, sort l-to-r and create 
boxes 

., contours, 
EXTERNAL, 


_ = cv2.findContours(canny output, cv2.RETR_ 


cv2.CHAIN_APPROX_SIMPLE) 
if len(contours) < 2: 
print("Couldn't detect two or more objects") 
exit(@) 


(contours, _) = imutils.contours.sort_contours(contours) 
contours_poly = [None]*len(contours) 
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TopTip ó 


Location, 
location, 
location 


Make sure you 
avoid your 1970s 
flock wallpaper. 
You need a well-lit 
plain background 
for this to work. 


This overlay shows 
how OpenCV has 
mapped the test 
image. It can be far 
more accurate, but 
this faster method 
meets our needs 


Although piwheels speeds things up considerably, 
you can expect the second command to take a 
little while to run, so now’s a good time to geta 
cup of tea. 


Calibration test 

Before we start running code, make sure 
everything is lined up as you would like it. The 
easiest way to do this is to open a Terminal prompt 
on the Desktop and run the following command: 


raspistill -t @ 


This puts the camera in ‘preview’ mode (you'll 
need to be directly connected to see this - it won’t 
work over VNC without extra configuration). Study 
the image carefully. Is the camera at an angle? Is it 
too high or low? Is there enough contrast between 
your object, plant, and background? How’s the 
light? Press CTRL+C when you’re finished. 


Coding time 

Enter the code from the plantbot.py listing 
in your editor of choice and save it. If you don’t 
fancy typing, you can download the code and some 
sample images from magpi.cc/akmZsW. The code 
takes an image from the Pi Camera as a stream 
and sends it to OpenCV. The image is then placed 
through some cleaning filters and the shapes 
detected. We know the nearest shape to the 0,0 
‘origin’ (the top-left of the image) will be our 
calibration object. So long as we know the width of 
that object, we can estimate the size of others. 
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07 Run the code 
Let’s take our first image. Carefully 
measure the width of your calibration object. 
Ours was 16mm. To run the code, enter the 
following command in the same location as your 
plantbot.py file: 


python3 plantbot.py -w 16 


Replace the ‘16’ with the width of your calibration 
object. After a few seconds, you'll see the image 
with, hopefully, a light blue rectangle around the 
leftmost object and one or more boxes around the 
plant. As the plant is an irregular object, OpenCV 
will find lots of ‘bounding boxes.’ The code takes 
the highest and lowest to calculate the height. 


Big plant data 

Once you’ve had fun measuring all the 
things, you can alter the code to write the results to 
a file. Add the following to the ‘import’ section at 
the start of the code: 


import datetime 


Now remove the final six lines (the first one starts 
‘print’) and replace with: 


print("\"" + str(datetime.datetime.now()) + 
"\"," + str(plantHeight) ) 


This version can be employed to create a CSV file of 
measurements that may be used to create graphs 
so you can track your plant’s growth. 


Keep on schedule 

Let’s say you wanted to take a measurement 
every day. You can do this by using Raspbian’s cron 
system. Cron is an easy way to run scripts ona 
regular basis. To access the main cron file (known 
as acrontab), run the following: 


sudo nano /etc/crontab 
At the bottom of the file, add this line: 
0 14 RE pi python3 /home/ 


pi/plantbot/plantbot.py -w 16 »» /home/pi/ 
plantbot.csv 
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m You can measure anything you want with 
this project, even growing youngsters, but 
why stop there? D 


A An example of what OpenCV sees, with the calibration 
object on the left, and some daffodils on the right 


This tells cron to run our script every day at 2pm 


(that’s the ‘0 14! bit) and append its output to D | a ntbot. py (co ntinued) 


plantbot.csv, which can be read by any popular 


spreadsheet app. 
> Language: Python 3 
039. boundRect = [None]*len(contours) 
Got water? 040. for i, c in enumerate(contours): 
Now you're collecting data on your beloved 041. contours_poly[i] = cv2.approxPolyDP(c, 3, True) 
plant’s height, why not add other data too? 042. boundRect[i] = cv2.boundingRect(contours_poly[i]) 
A common Raspberry Pi project is to use soil 043. 
moisture sensors. These are inexpensive and 044. output image - image.copy() 
widely available (magpi.cc/seyhTc). See if you 045. mmPerPixel = args[' width"] / boundRect[@][2] 
can change the script to get moisture data and 046. highestRect - 1000 
include it in the CSV output. You could even send 047. lowestRect - 0 
alerts when your plant needs some water. If you 048. 
imported weather data from free public APIs such 049. for i in range(1, len(contours)): 
as openweathermap.org/api as well, you could see 050. 
how changing conditions are affecting your plant! 051. # Too smol? 
052. if boundRect[i][2] < 59 or boundRect[i][3] < 50: 
053. continue 
054. 
More than plants 055. # The first rectangle is our control, so set the ratio 
You can measure anything you want with 056. if highestRect > boundRect[i][1]: 
this project, even growing youngsters, but why 057. highestRect - boundRect[i][1] 
stop there? You've now had a taste of the power 058. if lowestRect « (boundRect[i][1] + boundRect[i][3]): 
of OpenCV, which has many more capabilities 059. lowestRect = (boundRect[i][1] + boundRect[i][3]) 
than we’ve covered here. It is a powerhouse of 060. 
computer vision that includes machine-learning 061. # Create a boundary box 
capabilities that allow you to train your Pi to 062. cv2.rectangle(output image, (int(boundRect[i][9]), 
recognise objects, faces, and more. It's a popular int(boundRect[i][1])), 
choice for robot builders and plays a major part 063. (int(boundRect[i][®] + boundRect[i][2]), 
in the autonomous challenges of Pi Wars. We can 064. int(boundRect[i][1] + boundRect[i][3])), 
especially recommend pyimagesearch.com, which (255, 0, 0), 2) 
provided inspiration for this tutorial. 7 065. 
066. # late the size of our p t 
Top Ti p à 067. plantHeight - (lowestRect - highestRect) * mmPerPixel 
868. print("Plant height is (0:.0fjmm".format(plantHeight)) 
069. 
No plant? 070. # Resize and display the image (press key to exit) 


071. resized image = cv2.resize(output image, (1280, 720)) 
072. cv2.imshow('" Image", resized image) 
073. cv2.waitKey(®) 


If you don't have a plant or suitable environment, 
we've provided some sample images here: 
magpi.cc/omacNA 
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Mike 
Cook 


Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, 

and Raspberry 

Pi Projects 

for Dummies. 


magpi.cc/TPaUfT 


Play a five-colour 


Simon game 


Hack Lego Boost 
with Raspberry Pi 


Following last issue's introduction, this time we'll hack the Lego Boost kit 
some more, to gain extra control, and create some fun projects 


Boost robotics set to the Raspberry Pi, and 

how to communicate with it in Python. 
This time we look at three example projects, 
where we explore the finer points of control that 
are normally hidden from you by the standard 
Lego software. 

The Lego Boost system communicates with a 

Move Hub that receives instructions, in real-time, 
over Bluetooth - it does not store its own set of 
instructions. So your model has to be in Bluetooth 
range allthe time. This month we have three 
models to build, explore, and program. First, a 
simple but amusing use of the tilt sensor, then a 
machine to explore the performance of the colour 
sensor, and finally a colour sequence memory 
game. All parts for these projects can be built using 
the bricks that are included in the Lego Boost 
17101 set. 


| ast issue, we saw how to connect the Lego 


Playing a red tile 
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A Figure 1 Eyes Front - always start the software 
in this orientation 


Eyes Front 

We start with a very simple Lego build from 
the excellent book, The Lego Boost Idea Book, by 
Yoshihito Isogawa. It is a simple set of eyes that will 
always face to the front - well, in one dimension 
only. The idea is simple: measure the angle ofthe 
Hub and move the built-in motor to compensate for 
that movement. The Lego build is simple enough 
- see Figure 1. We also have full step-by-step 
pictorial build instructions on our GitHub repository 
(magpi.cc/dhaAam). The code to drive itis simple, 
but not as simple as you might hope. 


Eyes Front software 

The Python code for driving this is shown in 
the Eyes_front.py listing, and the alternative Lego 
language code is shown in Figure 2. It is interesting 
to note the difference in performance of the two 
code versions. The Lego language has a slow, 
hesitant movement, whereas the Python code has 
a much more robust feel about it. We did find that a 
straight translation from the graphics language into 
Python produced a system that would occasionally 
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Eyes front.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
088. 
089. 
010. 
011. 
012. 
013. 
014. 
015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 
026. 
027. 
028. 
029. 
03e. 
031. 
032. 


033. 


034. 
035. 


#!/usr/bin/env python3 

# coding=utf-8 

# Eyes Front - move motor A to match tilt angle 
# By Mike Cook March 2019 


from time import sleep 

from pylgbst import * 

from pylgbst.movehub import MoveHub 

from pylgbst.peripherals import TiltSensor 


motorAngle = @ 
tiltAngle = 0 
shutDown = False 


def main(): 

print("Eyes front - move the eyes to the front") 
conn=get_connection_auto() 
print("Hub connected, press Green button to end") 
try: 

movehub = MoveHub(conn) 

setup(movehub) 

while not shutDown: 

adjust(movehub) 


finally: 
movehub.tilt sensor.unsubscribe(callbackTilt) 
movehub.motor A.unsubscribe(callback A angle) 
movehub.button.unsubscribe(call button) 
conn.disconnect() 


def setup(movehub): 
movehub.tilt sensor.subscribe(callbackTilt, 
mode-TiltSensor.MODE 3AXIS FULL, granularity=1) 
movehub.motonr A.subscribe(callback A angle, 
granularity-1) 
movehub.button.subscribe(call button) 


036. 
037. 
038. 


039. 


040. 
041. 
042. 
043. 
044. 
045. 


046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 


054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 


© magpi.cc/dhaAam 
def adjust(movehub): 


maxA = 88 # maximum angle 
targetAngle = tiltAngle # so it won't change 
during this function 
if targetAngle > maxA: # limit target angle to 
approx +/- 90 Degrees 
targetAngle = maxA 


if targetAngle < -maxA: 
targetAngle = -maxA 


requiredMove = int(targetAngle - motorAngle) # 
amount required to move 
if abs(requiredMove) > 4: # to reduce jitter 
print("Moveing" ‚requiredMove) 
movehub.motor_A.angled(requiredMove, 0.02) 
sleep(0.5) 


def callbackTilt(roll, pitch, yaw): 

global tiltAngle 

#print("Tilt roll:Xs pitch:Xs yaw:%s" % (roll, 
pitch, yaw)) 

tiltAngle = pitch * 1.4 # under reporting pitch 


def callback A angle(param1): 
global motorAngle 
motorAngle - parami 


def call button(is pressed): 
global shutDown 
if not is pressed : 
print("Closing Down") 
shutDown - True 


if name  -- 
main() 


rotate outside the required parameters. This was 
caused by sending the motor commands too quickly 
- that is, before the previous one had finished. A 
small delay seemed to be the only cure. 


The colour sensor 

Next up, we wanted to make a Simon game 
using coloured tiles and the colour sensors, but 
we ran into difficulties getting all the colours 


Figure 2 


Aw 


am wm 


A Figure 2 The Lego language way to program Eyes Front 
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> Figure 3 A rendered 
image of the 
sensor tester 


TopTip A 


Setting the 
initial tile 
position 


The sensor tester 
should be wound 
back so the tile 

is touching the 
sensor before 
starting the Hub. 
Use your finger 
and thumb on the 
crank to wind the 
tile back. 


Y Figure 4 Colours 
reported against 
distance 


12 


© Bues © Green # 


recognised at a fixed distance. We thought it was 

a shame we did not have some sort of machine to 
test the colour sensor’s performance, but then we 
remembered that this was Lego and we could build 
one! So the next project turned out to be a colour/ 
distance sensor test bed, which proved to be fun and 
very interesting. The Lego model for this is shown 
in Figure 3, and step-by-step build instructions and 
software are again available on our GitHub repo. 


The colour sensor results 

Each tile colour was tested, and the software 
produced a CSV file we could import into any 
spreadsheet software for analysis. There were a 
total of 149 readings for each tile, giving a grand 
total over the six colours of 894 readings - for each 
parameter, distance sensor, and colour number. 
The raw CSV files are again on our GitHub repo, 
but in summary it is fair to say that when the tile 
was at a range where the colour sensor worked, the 
distance sensor produced nonsense. The colour 
sensor’s performance is summarised in Figure 4; 
‘not a colour! is number 255 and is off the graph. 


© Yellow # 
Colour Number for all tiles 


The colour sensor conclusions 

At close distances, the sensor would produce 
readings of black or no colour - 0 or 255 - then 
there would be a range where the reported colour 
was wrong, or would change from reading to 
reading. Then you got a period where the colour 
was consistent, before going into the oscillating 
values again, and finally ending up as no colour. 
The takeaway information from this was that all 
colours were correct from 6.17 to 16.18mm. That 
is a mid-range of 10.01mm, therefore the optimal 
range is 11.175 mm; unfortunately, this is a half stud 
quantity, making it difficult to achieve with Lego. 


Simon game 

We know that ambient light will affect the 
colour sensor’s performance, so we set out to try 
to exclude as much of it as possible. The result is 
that we built a box around the sensor with a slot in 
the top where we could insert the appropriate 2x4 
colour tile. This is shown in Figure 5 - again, full 
step-by-step instructions are on our GitHub repo. 
The only tile we had trouble with was the green one: 


O Whites © Black # 


O09009009009009090000000900090000000000000090900000000000000900000000000000000000000920900900000909090000 
06i 128 192 255 319 383 4. T $39 702 The 83 “594 958 1022 108S TT49 123, "T 1805 1408 1597 199€ 166 BE tase Tore 1079 2048 210 


Distance 
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colour_simon.py 


> Language: Python 3 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
088. 
089. 
010. 


011. 
012. 
013. 
014. 
015. 
016. 


017. 


018. 
019. 


020. 
021. 
022. 
023. 
024. 
025. 


026. 
027. 
028. 
029. 
830. 


031. 
032. 
033. 
034. 
035. 
036. 
037. 
038. 


#!/usr/bin/env python3 

# coding-utf-8 

# Colour Simon 

# By Mike Cook March 2019 


import time, random, os 

from pylgbst import * 

#import pylgbst 

from pylgbst.movehub import MoveHub 

from espeak import espeak # sudo apt install 
python3-espeak 

espeak.set voice = 'en' 


random.seed() 

shutDown - False 

lastColour = 255 ; updateColour = 0 

maxLength = 25 # maximum sequence before we 
decide you are cheating 

sequence = [ random.randint(0,3) for c in 
range(@,maxLength) ] 

maxFails = 3 # number of fails before game ends 
playingColours = 

["blue", "green", "yellow", "red", "white", "black" ] 
translateColours = [5,5,5,0,5,1,5,2,5,3,4] 
playingToLego = [3,5,7,9,10,0] 


def main(): 
global shutDown, movehub 
print("Colour tile Simon - press the green hub 
button to connect") 
conn=get_connection_auto() 
print("Trying to connect Hub") 
try: 
movehub = MoveHub(conn) 
print("Hub now connected - press Green 
button to end") 
init() 
espeak.synth("Colour Simon game") 
time.sleep(1) 
while not shutDown: 
fail = © # number of fails 
#generate new sequence 
for c in range(@,maxLength): 
sequence[c] = random.randint(@,4) #use 
five colours 


039. 
040. 


041. 
042. 
043. 


044. 
045. 
046. 
047. 


048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 


060. 
061. 


062. 


063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 


071. 
072. 
073. 
074. 


075. 


far = 2 
while fail < maxFails and not shutDown: # 
number of fail attempts before reset 
print("a sequence of length",far) 
saySeq(far) 
if getSeq(far) != -1 and not shutDown:# 
if entered sequence is correct 
far = far + 1 
if far <= maxLength: 
espeak.synth( yes") 
print("Yes - now try a longer 


one") 
time.sleep(1) 
espeak.synth("adding one more") 
time.sleep(1) 
fail = 0 # reset number of fails 
else: 
if not shutDown: 
fail = fail +1 
print("Wrong",fail,"fail") 
if fail « maxFails: 
espeak.synth( "no" 
print("try that one again") 
espeak.synth("try that one 
again") 
else : 
print("maximum tries 
exceeded") 
espeak.synth( "maximum tries 
exceeded") 
time.sleep(2) 
espeak.synth("your score is") 
time.sleep(1) 
espeak.synth(str(far- 1)) 
time.sleep(1.5) 
if far > maxLength and not shutDown: 
print("Well done Master Mind") 
espeak.synth("this is too easy for 
you") 


shutDown = True 
if not shutDown: 
espeak.synth("Game over") 
print("Game over - Your score 
is",far-1) 
print("Try again") 
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A Figure 5 Simon 
sensor with red tile 


TopTip è 


The Boost 
distance 
sensor 


Remember that 
the distance 
sensor returns 
values in inches, 
at inch or half 
inch intervals. 
This gives a 
stepped response 
for distances 

over an inch. At 
distances under 
an inch, values 
are returned but 
they are not in the 
same range as 
bigger distances. 
White tiles are the 
best for distance 
measurement. 


it would not read when the smooth face was placed 
towards the sensor, but only the other way round. 
All the other tiles worked either way round. 


07 Simon software 

The software for the Simon game is shown 
in the colour_simon.py listing. The colours of the 
current sequence are called out using the speech 
synthesizer eSpeak; if you don’t have this installed, 
then a simple sudo apt install python3-espeak 
from a Terminal window will install it. The sequence 
is also displayed on the Hub’s LED. Each time you 
get a sequence correct, an extra colour is added onto 
the end and getting a sequence wrong for three 
consecutive times results in that round being over. 
You can quit at any time using the Hub’s green 
button. The fact you have physical colour tiles 
makes the initial stages simple, as you can simply 
put them in the correct order. 


Customising the software 

You can change the number of times you get 
to complete a sequence by changing the maxFails 
variable. Sometimes we think that three attempts 
is a bit much when the sequence gets long. Of 
course, you can simply write down the sequence, 
but that defeats the object of the game. The 
maxLength variable determines how long a sequence 
to generate before the program decides you are 
cheating and shuts down. You can comment out or 
simply turn off the audio if you want the sequence 
to be delivered in the form of the LED colour only. 
You could replace the synthesizer sounds with 
samples, for better quality. 
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A Figure 6 A rendered image of the Simon sensor 


Virtual Lego 

The step-by-step instructions on our GitHub 
repo are generated by a free software application 
called Studio 2.0. This is a3D CAD system that 
can be used to build a virtual Lego model, view it 
from all angles, and produce staggeringly realistic 
photographic-quality rendered images of your 
model. Figure 6 is the rendered version of the 
photograph we have in Figure 5. The application is 
written by BrickLink, and you can take your model 
and generate an order for exactly the bricks you want 
to generate the real thing, but this can be expensive. 


Studio 2.0 

Unfortunately, Studio 2.0 is not available 
for Linux, so you can’t run it on the Raspberry Pi, 
but there are Windows and macOS versions. It is 
actively being supported, unlike the older official 
Lego tool LDD (Lego Digital Designer) which seems 
to have been neglected recently - these older 
models can be imported into Studio 2.0. There are 
still some things that Studio 2.0 will not currently 
cope with, like flexible linkages, but no doubt they 
will appear in due course. See our GitHub repo for 
notes on setting up Studio 2.0 to get the missing 
Boost-specific parts like the Move Hub. 


In conclusion 

In the final part of this series, we will explore some 
of the things you can do to make music using the 
Lego Boost system. I] 


Disclaimer 


LEGO® is a trademark of the LEGO Group of 
companies, which does not sponsor, authorise, or 
endorse this article. 
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colour simon.py (continued) 


076. time.sleep(2.0) 113. print("Now you try") 

077. else: 114. for press in range(0, length): 

078. espeak.synth("closing down good bye") 115. if shutDown: 

079. 116. return 1 

080. finally: 117. attempt = getTile() 

081. print("shutting down") 118. movehub.led.set color(playingToLego[5]) # 

082. movehub.button.unsubscribe(call button) turn off LED 

083. movehub.color distance sensor. 119. if attempt !- sequence[press]: 
unsubscribe(callback colour) 120. time.sleep(0.8) 

084. conn.disconnect() 121. return -1 

085. 122. return 1 

086. def init(): 123. 

087. movehub.led.set color(playingToLego[5]) 124. def callback colour(colour, distance): 

088. movehub.button.subscribe(call button) 125. global lastColour, updateColour 

089. movehub.color distance sensor.subscribe( 126. if distance «- 1.2: 
callback colour, granularity=®) 127. if colour != 255 and lastColour !- colour 

898. and colour!= 8: # ignore no colour 

091. def getTile(): 128. updateColour += 1 

092. global lastColour, updateColour 129. #print(colour) 

093. while updateColour < 3 : 130. if updateColour > 2 : 

094. if shutDown: 131. lastColour - colour 

095. return 5 132. if colour -- 255 : 

096. #print("colour",playingColours[correctColour 133. lastColour = 255 
(lastColour) ]) 134. else: 

097. updateColour = ® 135. lastColour = 255 

098. espeak.synth(playingColours[ 136. 
correctColour (lastColour) ]) 137. def correctColour(colour): # translate LEGO 

899. movehub.led.set color(playingToLego[ colours to playing colours 
correctColour(lastColour)]) # turn on LED 138. if colour == 255: 

100. return correctColour(lastColour) 139. correctColour = 5 # black 

101. 140. else: 

102. def saySeq(length): 141. correctColour = translateColours[colour] 

103. for num in range(0,length): 142. return correctColour 

104. espeak.synth(playingColours[sequence[num]]) 143. 

105. movehub.led.set color( 144. def call button(is pressed): 
playingToLego[sequence [num] ]) 145. global shutDown, updateColour 

106. time.sleep(0.8) # time between saying colour 146. if not is pressed : 

107. movehub.led.set color(playingToLego[5]) 147. print("Closing Down") 

108. time.sleep(0.5) 148. shutDown - True 

109. 149. updateColour = 0 

110. def getSeq(length): 150. 

111. movehub.led.set_color(playingToLego[5]) # turn 151. if name == ' main ': 
off LED 152. main() 

112. espeak.synth("Now you try") 
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Start creating GUIs 
with C and GTK 


With a grounding in C programming, you are ready to 


start creating GUIs using GTK 


C & GUI Programming, we learn the basics of 

the C language, and see how to use it to write 
text-only programs to run at the command line. 
Looking at the keywords and library functions 
covered, it isn’t obvious how to create everything 
required for a full GUI - desktop, windows, icons, 
mouse pointer, and so on - with them. 

It is entirely possible to do so in C, but to be 
honest, it would be incredibly long-winded and 
time-consuming. You need to find the screen 
buffer in memory - the part of memory that 
represents the pixels which make up the desktop 
on the screen - and then write new pixels to it for 
each window; you then have to write even more 
pixels to it to show where the mouse cursor is. You 
then have to monitor when the user moves the 
mouse, and redraw the pointer each time, and then 
when the user clicks the mouse button, you have 
to work out where on the screen the pointer is and 
whether it is on top of a window, and so on... 


| n the first half of the book, An Introduction to 


An Introduction 


toC & GUI ` 
Programming 


INTRODUCTION 


C«GUI 


For further tutorials on how to start coding 
in C and creating GUIs with GTK, take a 
look at our new book, An Introduction to 

C & GUI Programming. Its 164 pages are 
packed with all the information you need 
to get started - no previous experience of 
C or GTK is required! 

magpi.cc/GUIbook 
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Funnily enough, that isn’t how it’s usually 
done in practice - life is too short! Most of this 
functionality has already been written for you. 
Windowing systems like X provide most of the 
underlying features, and then user interface 
libraries provide a convenient means of creating 
GUI applications which work with the likes of 
X; all you need to do is choose a suitable user 
interface library, and use the predefined functions 
in it in your C program. 

There are lots of user interface libraries 
available; some are designed to work witha 
particular desktop environment like Windows or 
macOS, while others are cross-platform and can 
work in a choice of desktop environments. The 
one which is used most often in the Raspberry Pi 
Desktop included with Raspbian is called GTK, and 
that’s the one we are going to look at here. 


What is GTK? 

GTK (formerly known as GTK+) is short for ‘GIMP 
ToolKit’. Its website (gtk.org) describes it as “a 
multi-platform toolkit for creating graphical 

user interfaces”, and it was originally written to 
provide the user interface elements used to create 
the GIMP picture-editing program. 

It has grown beyond that into a general user 
interface toolkit, and is now one of the most widely 
used user interface libraries on the Linux desktop. 

The fundamental building blocks of GTK 
projects are called widgets. Everything you see 
on the screen - a window, a button, a label - isa 
widget. The GTK library does all the work required 
in creating widgets - all you need to do is to tell it 
what widgets you want, whereabouts you want to 
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put them, and what you want them to do, and GTK 
will manage everything else for you. 

To give you an idea of what “manage everything 
else’ means, imagine the situation described 
above where you are manually creating a window 
by drawing pixels by writing data to the screen 
buffer. If the user clicks on the window title bar 
and drags it to another place on the screen, you 
have to detect that the mouse has been clicked, you 
have to track that it is being moved, and you have 
to redraw the window at each point as it moves, 
restoring what was underneath it in the areas 
from where it has moved. Just dragging a window 
would be hundreds of lines of code - but with GTK, 
you create a “window? widget (with a single line of 
code) and all of that is taken care of for you. 

Libraries like GTK therefore make the creation 
of rich graphical user interfaces relatively easy, 
and you may be surprised by just how little code 
you need to write to get something working. 


~ |gnome-mime-application-rtf.png (400.6 kB) 


GTK 2 and GTK 3 

One thing worth noting at this point is that there 
are two versions of GTK in use. The current version 
is GTK 3, and this is still under active development 
- it changes quite a bit between releases. 


< The GIMP image 
editor, created 
with GTK 


For this reason, many people prefer to use 
the older version, GTK 2. This offers most of the 
same functionality, but it is stable code which 
doesn't change very much any more. Some say 
that it is always better to use the latest and 
greatest version of anything, but more cautious 
old engineers (like your author) tend to prefer the 
older version that has had a lot more testing and 
with which people have stopped fiddling about! 
In terms of the examples we are looking at here, 
there aren't that many significant differences 
between the two, but just to be clear, the 
examples in this tutorial series will use GTK 2. 


m Libraries like GTK make the creation 
of rich graphical user interfaces 
relatively easy Z 


A note on theming 

One of the powerful features of GTK is theming. 
The appearance of every widget in GTK can be 
customised in pretty much every detail, from the 
colour of the text to the shape of the corners ona 
button. This customisation is completely separate 
from the actual coding of a GTK application; 
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P The output of 
pkg-config is a long 
list of the flags and 
libraries that neec 
to be passed to the 
compiler to build a 
GTK program 


instead, the appearance of widgets is controlled by 
the current theme which is in use on the system 
on which the GTK applications are running. 
Creating a theme is beyond the scope of 
this series - it's quite a complicated and fiddly 
procedure. All the example screenshots in this 
guide were taken from a Raspberry Pi running the 
Raspberry Pi Desktop environment, which uses a 
custom theme called PiX. If you are working with 
GTK on a different computer with a different theme, 
your widgets may look slightly different from those 
pictured, but the code you write will be the same. 


#include <gtk/gtk.h> 


This is an instruction to the preprocessor to tell it 

that we are writing a GIK program, and to load the 
GTK header files. Without this, the compiler won’t 
recognise any of the GTK library functions that we 
are going to use. 


int main (int argc, char *argv[]) 


This is the standard starting point of aC program 
- amain function with some arguments and a 
return value. 


gtk_init (&argc, &argv); 


Your first GTK program 


Let’s create a simple GIK program. Open your 
favourite text editor, and write the following. 


#include <gtk/gtk.h> 


int main (int argc, char *argv[]) 


{ 


gtk_init (&argc, &argv); 


GtkWidget *win = gtk_window_new (GTK_ 


WINDOW TOPLEVEL); 
gtk widget show (win); 
gtk main (); 
return 0; 


We said you didn’t need much code! Let's look at 
that line-by-line before we try to run it. 
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This is our first piece of GTK code. You need to call 
gtk init at the start of every GTK program - this 
initialises all the internal variables used by the GTK 
library and sets it up ready to use. (Note that any 
command-line arguments supplied to the program 
are passed on to the GTK library via the arguments 
to this function.) 


GtkWidget “win = gtk window new (GTK 
WINDOW TOPLEVEL); 


This creates a widget of type GtkWindow. For every 
type of widget in GTK, there is a new function 
which creates an instance of that widget and 
returns a pointer to it. 


gtk widget show (win); 


This tells GIK to show the widget we have just 
created. The previous line created the widget ina 
hidden state; widgets can only be seen if they are 
unhidden with a | show call like this. 


gtk_main (); 


The gtk_main call runs the main loop of GTK; this 
effectively hands control of the program to GTK 
itself, which then processes any user events like 
button pushes to control the user interface you 
have created. 


return 0; 


Formally, as this is a C program with the main 
function returning an integer value, we need to 
return a value. However, this is largely pointless 
with a GUI program where the command line, 

and hence any return value, is usually never seen 
anyway; it's included here for completeness, but 
to save space, it won't be in any other examples in 
this tutorial series. 

That's really all there is to it - that's the simplest 
GTK program which will do something sensible. 
Type it in using your favourite editor and save it as 
gtktest.c. Now we need to build and run it... 


m We need to tell the 
linker that we want the 
program linked with the 
GTK library files @ 


Building a GTK program 

If we're writing a standard command-line C 
program, we can just use the gcc compiler to 
build our source file - gcc gtktest.c would 
produce an executable file. However, things are 
not quite so simple if we are using an external 
library like GTK. 

First, we need to make sure that the relevant 
GTK libraries are installed. To do this, type sudo 
apt-get install libgtk2.0-dev into a Terminal 
window and answer yes to any prompts - this 
installs the developer libraries for GTK 2. 

Now we need to tell the compiler where to find 
the GTK header files, and also we need to tell the 
linker that we want the program linked with the 
GTK library files, or all the ‘GTK-ness’ we want to 
use will be unavailable. 
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There is a utility called pkg-config that helps 
here. pkg-config is a tool which generates 
the arguments required by gcc in order to use 
additional libraries. Try typing pkg-config 
--cflags --libs gtk«-2.0 at the command line 
and look at the output. You'll see a list of strings - 
those which start -I/ are the directories where the 
GTK include files are stored, and those which start 
-lare the names of the GTK library files. 

All of these need to be added to the gcc 
command line in order to build our GTK program, 
so the pkg-config command is enclosed within 
back-ticks (`), like so: 


gcc pkg-config --cflags --libs gtk+-2.0° 
gtktest.c -o gtktest 


If you run this, you should end up with an 
executable file called gtktest. Run this by typing: 


./gtktest 


...and see what happens. 

You should see a small grey square window 
open somewhere on your desktop; it won't do 
much, but you can drag it around and minimise 
and maximise it. If you press the X in the top- 
right corner, the window closes, but if you look in 
the Terminal window from which you ran gtktest, 
you'll see the program is still running. This is 
because closing a window doesn't terminate the 
gtk main function, which will carry on running 
until you hit CTRL+C in the Terminal window. 

Congratulations! You've just created your first 
GUI application with GTK. In the next guide, we'll 
put something onto that empty window. El 


"d < Your first 
GTK window 


— cm 
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DIY Games 
Console 


QZOGEMHAGU 5 SEDI JO SoOUO ODE 


200 pages of 


THE Official 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 4 


Amazing hacking and making projects 
from the makers of MägPi magazine 


Inside: 
@ How to get involved with the Pi community 
@ The most inspirational community projects 
@ Essential tutorials, guides, and ideas 


@ Expert reviews and buying advice 


ui le e 
(GD magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
€ App Store j> Google Play 
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Build a car computer 


ne of the ultimate mods for modern cars 

is to replace or upgrade the entertainment 

system. This can range from something as 
mall as adding new speakers, to replacing the 
stock stereo, or - in our case - creating a custom 
computer purpose-built for your car. 
The Raspberry Pi is fantastic for this task. It’s 
small enough that it’s easy to hide, and powerful 
enough to handle simple telemetry, dash-cam 
recording, GPS, and more. Thanks to AutoPi, you 
>t need to be deep in the bowels of your car 
snipping wires, either, and you can control it using a 
cloud-based service. Let’s make your car futuristic! 


n 


In-car entertainment 


From radios to computers 


t may surprise you to learn that it was back 

in 1904 that the first in-car entertainment 

system - in the form of a car radio - was 
demonstrated at the Louisiana Purchase 
Exposition (an old-time world’s fair) by the 
father of radio himself, Lee de Forest. That 
must have been extraordinary - cars themselves 
a very new concept, and radio not too old either. 
It wasn’t commercially viable at all, but can 
you imagine? 

By the 1920s, radios began to be installed in 
cars, with AM-radio-equipped cars numbering 
9 million by the late forties. 


FM, tape, and beyond 


It’s in the fifties that in-car entertainment started 


to resemble what we see in cars today. First was 
FM radio. In the sixties, tape players in the form 
of cassette and 8-track started appearing. Now 
you could choose your music in your car. How 
fantastic is that? 

From there, CD players exploded in the 
nineties, followed by the classic ‘back of the 


A A classic CD/stereo head unit, removable to deter 
enterprising thieves 


WARNING! 


For the safety of yourself 
and other motorists, you need 
to make sure your eyes are on 
the road while driving. This is also 
the law in many countries. Make 
sure your interactions with your 
new computer are minimal while 
driving, and do not under 
any circumstances play 
videos for yourself. 


W The 1937 Philips 
Auto Radio weighed 
24kg and took up 

eight litres of space 
on the floor 


A This style of stereo 8-track unit from a 1978 
AMC Matador almost defines the look of cars in 
seventies and eighties cinema. Credit: CZmarlin 


seat’ DVD players for the kids, satnav | 
boxes you'd stick to the windscreen, | 
dash-cams, auxiliary in, USB in, SD | 
card slots, Bluetooth syncing, and | 
even WiFi connectivity. It's frankly 
incredible how quickly we've moved 
from a pouch of CDs in the glove 
compartment to your podcast 
picking up where you left it as you 
turn on your car. 


"Pile cad ang 
7H rriceedes ka 
Aimatingan van bet enq: EE 


Me 247 B en 
XOX 18 em, Ordieninsskune, 


We can do better 

The stock systems aren’t always 
amazing, though, are they? They have potential 
but the UI is lacking or it’s missing some key, 
seemingly obvious feature. Ours sometimes 
crashes during navigation, which can be 

fun. People have been replacing their in-car 
entertainment with custom computers for years; 
however, it’s now far easier than ever thanks to 
the Raspberry Pi. 
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S 
Install the car computer 


A step-by-step guide to installing a Pi-based ICE system 


SHOPPING 
LIST 


» Raspberry Pi 3B or 3B* 


» Raspberry Pi 7-inch 
Touchscreen Display 
magpi.cc/ajiRqK 


SmartiPi assembly 

The SmartiPi Touch case is pretty easy to 
put together. If you want to make sure you're 
doing it 10096 correctly, you can always follow the 
YouTube assembly guide: magpi.cc/ZMwmBf. 


» SmartiPi Touch case 
magpi.cc/snAgQD 


» AutoPi Dongle with OBD-II 


ccn Add the AutoPi adapter 

The AutoPi hardware comprises two parts: 
the adapter board that slots onto the Raspberry 
Pi like a HAT, and the OBD-II dongle. The adapter 
board's spacers need to attached to both the Pi and 
the adapter before affixing it onto the GPIO pins 
and fastening the board to the Pi with some nuts. 


» AutoPi Raspberry Pi 3 Adapter 
magpi.cc/vsuXBp 


> 2 x GoPro adhesive mounts 
magpi.cc/KqMiTE 


> Raspberry Pi Camera Module 
magpi.cc/camera 


e 
< 
= 
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Attach the dongle 

With the adapter in place, you can now add 
the dongle on top and fasten it in place with some 
screws. You'll need to take it apart first and remove 
the Pi Zero inside. There will be a little hanging 
cable to connect to the 4G modem, which attaches 
to a USB adapter that goes into the Raspberry Pi. 


Set up the SD card 

You can use the provided microSD card, 
but we always find it best to flash a new one. Grab 
the latest AutoPi image (magpi.cc/rjUgKg) and 
then install it using Etcher to your microSD card. 
Not used Etcher before? Learn how in our handy 
video: magpi.cc/Zibvmu. 


© Etcher = 


SELECT MAGE SELECT DRIVE FLASH IMAGE 


2016-05-27-r...n-jossio.img Flash! 


"ETCHER @resinio 


You'll need a 
touchscreen to see 
the AutoPi interface 


Slot the dongle on 
top of the adapter 
board and Pi 


Don't place it in a location that will 
obscure your field of vision 


Finish and mount 

Now you’ve got a working car computer 
with a touchscreen, you can mount it in your car. 
They are some fairly common sense rules on how 
to do this. The main takeaway is: don’t place it ina 
location that will obscure your field of vision and/ 
or be distracting. The usual ‘bottom middle of the 
windscreen’ with GoPro mounts is quite a good 
spot, otherwise you can mount it to the dash if 
you’re confident in your abilities. 
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Once connected, the 
AutoPi system should 
boot up 


The car's OBD-II port 
can often be found 
under the dashboard 


magpi.cc Build a car computer 


Connect to OBD 

You can now connect to your car computer 
using the OBD-II port of your car - you may have 
to Google your car make and model to find out 
where it is, but a lot of the time it’s under the 
dashboard. Connect the OBD extender between it 
and your Raspberry Pi. 


Initial startup 

The OBD-I port powers your AutoPi system, 
and it should boot up once it’s connected. By 
default, there is no graphical user interface for 
AutoPi (you usually just read the data online on 
another computer); however, we can change that. 


Sign up for AutoPi.io Cloud 


WHERE DO You LIVE? 


Create an AutoPi account 

Head to my.autopi.io and log in to your 
AutoPi account - if you don’t have one, it’s free 
to register. If you’re using a brand new dongle, 
you can register it here so that you can then get 
data from it and make changes. If you’ve used the 
dongle before, you'll need to generate a new ID by 
going to the Terminal and using the command: 


grains.get id 


Install a graphical interface 

You'll need to install a graphical inteface 
using Chromium in web kiosk mode. The full 
guide on how to install the interface and configure 


AutoPi.io 


e & Add-ons « 


Dongle Status 


it can be found here: magpi.cc/accZdy. You can 
tweak the config file to your specific needs. 


Configure your interface! 

The basics are all done! From here you 
can start adding extra functionality using 
the other add-ons, and rearrange the in-car 
interface to your heart’s content. Enjoy your new 
car computer! 


M Log in to your AutoPi 
account - if you don't have 
one, it's free to register E] 


-— [J — = 
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Upgrade your computer 


Want to do more? Here are some top tips... 


utoPi is extremely smart - plugging in 
A specific sensors and inputs allow you to 

quickly add extra functionality to your 
computer. Here are some classics. 


Dash-cam 

Dash-cams have risen in popularity in recent 
years for many reasons - mostly safety and 
insurance related, but if you’re taking a quick trip 
around the Nürburgring it’s nice to have a record 
of your fastest lap. With our specific setup, you 
can actually use the Raspberry Pi Camera Module; 
however, a USB webcam will also do the trick if 
you have a spare one. 


Parking sensor 

External parking sensors are a great for helping 
you park while reversing, and it’s a popular 
addition on many cars. If your car doesn’t have 
one by standard, you can add external ones that 
connect to your AutoPi. Even if you do have rear 
sensors, it never hurts to have a front parking 
sensor for when you’re in a really tight spot. 
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Find a lot 
more AutoPi 
ideas here: 
magpi.cc/ 
QUYRQG 


Voice control 
A lot of modern cars now also include voice 
control as standard. They're usually not amazing, 
especially compared to your smartphone, but 
they're installed nonetheless. By plugging in a 
USB microphone you can create custom voice 
commands for your AutoPi, which can be much 
safer than using the touchscreen while driving. 


Simple coding for total beginners 


The first 
Code Club book 
has arrived! 


Learn to code 
using Scratch, the 
block-based language 


sg aN 9po- 


Follow step-by-step 
guides to create games 
and animations 


Use the magic glasses 
to reveal secret hints 


Includes 24 exclusive 
Code Club stickers! 


The special spiral 
binding allows 
the book to lay flat 


Raspberry Pi 
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balenaFin 


POWER RANGE: 
6 to 24V 


COPROCESSOR: 
Artik 020 with 
32-bit ARM 

M4 core 


STORAGE: 
eMMC 
8/16/32/64GB 


PORTS: 
mPCle, nano 
SIM, HDMI, 
2 x USB 2.0 


W The balenaFin 
from the top and 
bottom - the latter 
view showing 
the Compute 
Module attached 
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> balena » balena.io/fin b From £119 / 8155 


A carrier board for the Raspberry Pi Compute Module 3 Lite, designed 
for the Internet of Things. Brian Corteil takes a walk on the WiFi side 


alena was formerly known as Resin.io and 
B is the developer of the cross-platform app 
Etcher, used for flashing OS images to SD 
cards and USB drives. The company also provides 
a platform for Internet of Things in the cloud - in 
its own words, “Balena is a complete set of tools 
for building, deploying, and managing fleets of 
connected Linux devices." 
Part of this set of tools is a carrier broad for 
the Raspberry Pi Compute Module 3 Lite (CM), 
called the balenaFin. You can think of it being 
like a PC motherboard, and it shares many of the 
same features. 


Useful loT features 
The hardware is designed for commercial use, 
for the Internet of Things (IoT), and has a few 


balenaFin 


e... 


useful features to this end. These include a wide 
power input range, real-time clock (RTC), a micro 
coprocessor (Artik o2o), WiFi/Bluetooth, and a 
full 40-pin I/O Raspberry Pi compatible header. 
There are also sockets for mPCle, nano SIM 
(continuing the IoT theme), and HDMI, plus two 
USB 2.0 ports, power connectors, and a debug 
port for flashing the eMMC (8/16/32/64GB). The 
mPCle socket can be used to add more storage 

or connectivity. 

The microprocessor can run real-time jobs and 
wake up the CM at predefined conditions — for 
example, at 16:00 each day, or when a response 
is required because an input changes status. The 
balenaFin internal WiFi antenna can be bypassed, 
and an external WiFi/BT uFL antenna added to 
improve the range of the WiFi/Bluetooth. 


BARANG LL Lee LS 
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News flash 


As this review was being written, balena blogged 
about the next version of the balenaFin. Highlights are 
that the DSI display connector can be configured as a 
second camera port, allowing for stereoscopic camera 
functionality, and there's PoE compatibility via a HAT. 


As with any new toy, the balenaFin was passed 
to our friendly electronics engineer, Rob Karpinski, 
and he made happy noises while he was looking at 
it — his final word when passing it back was “Nice.” 
The build quality is of a high standard, with great 
attention to detail. 


Some tests 
So, where to start? First, the CM was installed in 
the balenaFin with a satisfying click. Following 
the guide on the Raspberry Pi website, the latest 
version of Raspbian was flashed to the balenaFin's 
eMMC via the debug socket. Next, we connected 
a keyboard and HDMI monitor. On powering up 
with the supplied PSU, we were happy to see the 
standard Raspbian welcome screen, and were able 
to connect to our network via WiFi and update 
the system. 

We then tested the 40-pin header. For this, 
some HATs/pHATs from Pimoroni were selected, 
software downloaded, and we installed their 


À Itincludes a slot (far 
right) for a nano SIM 


The board is packed 
with connectivity, 
including a 40-pin 
GPIO header 


m You can think of it being like a PC 
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motherboard and it shares many of the 


same features EJ 


Python libraries and examples. First up was the 
Unicorn HAT HD; we loaded the rainbow example 
and it ran with without any issues. The Scroll pHAT 
was up next; once again, after loading the drivers 
and the examples, it worked first time. 

Next up was the RTC. Following the Pi Hut 

guide suggested by balena, we were able to update 
the RTC with the current time, and the time was 
still correct when it was rebooted without an 
internet connection. 


So, what is it good for? 

We can see the balenaFin being used in intelligent 
displays, monitoring/controlling equipment/ 
sensors - the normal IoT things. It would make 

a good contender for the brains of a robot, with 
the addition of a motor controller HAT. The 
inclusion of the 40-pin header allows the use 

of many HATS/pHATS to expand the function of 
the balenaFin. M 


Verdict 


The well-made 
balenaFin has 
some useful 
features - for 
signage, a control 
System, or even 

a robot. Being 
able to use HATs 
with it is useful 
for customising 

it to a project's 
requirements. If 
you can afford it, it 
should be a good 
fit for your project. 


8 10 
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Breadboard 
Pi Bridge 


> RasPiO b magpi.cc/beWju0 p £12/S16 


Couple a breadboard to your Pi with GPIO 
ports in numerical order. By Phil King 


HEADERS: 
Female 2x20- 
pin, male 30-pin 


BREADBOARD: 
Half-size - 
400 points 


COMPONENTS: 
5 x 10mm LEDs, 
5 x resistors, 
GND wire 


Verdict 


While the 
automatic 
connection of 
breadboard 

rows to GPIO 

pins reduces 
component 
placement 
flexibility, the 
Bridge is a neat 
solution to 
making circuit 
building easier for 
newcomers. Ideal 
for classroom use. 


8 10 


imed at making electronic circuit 
A prototyping neater and easier, the 

Breadboard Bridge Pi integrates a 
half-size breadboard (included) and Raspberry Pi 
into one unit, while arranging the GPIO pins in 
handy numerical order. 

Coming in kit form, it requires the soldering of 

a female 40-pin GPIO header to the linking PCB, 
along with 28 male pins for 26 GPIO ports, 3V3 
power, and GND. You'll then need to assemble 
the frosted black Perspex pieces to secure the 
breadboard and Raspberry Pi with nylon screws 
and standoffs. There's also the option of placing 
a Perspex cover over the Pi, with a breakaway 
corner to allow room for the PoE four- pin header 
on the 3B*. 


No messy wiring 
With assembly complete, you can start placing 
components on the breadboard, each of its 


À Atop-down view with the Pi cover removed - 
necessary for access to its Camera and Display ports 
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A Wiring up a circuit is simple with the supplied 
LEDs, resistors, and ground rail connection wire 


near-side rows being connected to a numbered 
- and therefore easily identified - GPIO port on 
the PCB. Using the supplied five 10 mm LEDs 
and resistors, it soon becomes apparent how 


m It soon becomes apparent 
how easy this makes it to 
create simple circuits with 
hardly any wiring @ 


easy this makes it to create simple circuits with 
hardly any wiring. With the LEDs spanning the 
breadboard gutter and the resistors connecting 
them to the far ground rail, all you need is a single 
wire (supplied) to connect the latter to the other, 
near-side ground rail. 

This arrangement does have a few limitations. 
Since all the near-side breadboard rows are 
already connected to GPIO pins, you can't place 
components sideways - they'll need to span the 
gutter, or be placed on the unconnected near rows 
(to one side) or on the far side and connected with 
jumper wires. Even so, for basic circuits, it should 
make it much easier for physical computing 
newcomers to get started. WI 


OR COMPUTING 


SUBSCRIBE + 


Combining computer science & literacy 


& DIGITAL MAKING EDUCATORS 


INTERACTIVE 
INPRINTANDDIGITAL J 2 
FIND US ONLINE: sem cr kd; 


helloworld.cc EAC 
` gjHelloWorld. Edu Ë deliro aoi | ine‘ : š < sj Ë = hei 
(f fb.com/HelloWorldEduMag -— 


coder Can Í start a 


CoderDojo club 
in my local area? 


CoderDojo is a global network of free, volunteer-led, project-based 
programming clubs for children aged 7-17. Dojos are championed by 
individuals all around the world who are passionate about giving young 

people the opportunity to learn to code. 


incredibly 
rewarding experience 


“| started a Dojo to give my kids a place to meet other children also 
interested in programming and making games. | get to see them 
making new friends, learning from one other, and they loved it. 
Realising how | had created such a wonderful place for children has 
ignited a spark in me.” 

- Maroes, CoderDojo NL 
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PiTalk ` 


MOBILE 
COMMUN- 
ICATIONS: 
š; UMTS/HSDPA 
b SB Components P pitalk.co.uk » £58 / $76 anad CM7 

GPRS/EDGE 

Turn your Pi into a 4G mobile phone with the PiTalk HAT l SPEAKER / 

| p — ML 

from SB Components. PJ Evans keeps talking configures the Pi for you On-board 

jumpers 
ver the past few years, we’ve been lucky small touchscreens that can be added to create i 
Q to see the Raspberry Pi get more and more a more phone-like experience. 
communication options. It's no surprise To get everything running, software is supplied, LOCATION 

then that there's been great interest in getting but this is squarely aimed at the touchscreen. SERVICES: 

Pi devices onto the mobile data network. SB Although we were able to make voice calls, send Quec Locator. 

Components’ PiTalk range does just that, except SMS messages, and transmit data, the interface is a 

rather than stopping at just a data-capable device, poor to unusable without a touchscreen. cell tower 

the PiTalk HAT turns your Pi into a fully-fledged It is not an end-user product, but rather 

smartphone with voice and SMS support. something on which other projects can be based. 

5 m Perfect if you are interested in 

The standard-size HAT features a Quetec SoC that 

adds everything the Pi needs to get on the mobile remote automation El 

data network; you only need to provide a micro 

SIM. Our tests with EE met with failure, but a We were able to find an example project using 

Vodafone SIM worked first time. As the HAT only Python to exchange SMS messages and trigger 

uses serial communications, nearly all the GPIO GPIO pins in response. It's great for experimenting 

pins remain unused and the HAT has 'through? with smartphone technology, and perfect if you are 

pins for further expansion. SB offers a range of interested in remote automation. El 

W The smartphone interface could be Flossen -ı 


improved for desktop monitors, but p 7” 
did work as advertised 


0755555555. Verdict 


While let down by 
a tricky interface, 
the PiTalk is 

ideal for makers 
planning remote 
monitoring 
projects. It's better 
combined with 

a touchscreen. 


1» 
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JAM HAT 


COMPONENTS: 
2 x Tactile 
‘push to make’ 
buttons 


6 x ‘Traffic light’ 
LEDs (2 x red, 

2 x yellow, 

2x green) 


1x Buzzer/ 
sounder 


Verdict 


It's a neat solution 
to adding buttons, 
LEDs, and a buzzer 
to a Raspberry Pi. 
You lose some 

of the fun of 
wiring everything 
up manually, 

but it'll be great 
for classroom 
environments. 


9, 10 
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> ModMyPi P magpi.cc/jMxZCU p £7/S9 


A It connects directly on top of the 
Raspberry Pi and uses standoffs 
to fit securely to the board 


ModMyPi's board for adding lights, buttons, and a buzzer to the 
Raspberry Pi is a great solution for newcomers. By Lucy Hattersley 


any Raspberry Pi starter projects involve 
M LED lights, buttons, and buzzers. 

ModMyPi's JAM HAT brings these 
components together into a single, simple board 
that slots neatly on top of the Raspberry Pi. 

On the board you'll find six LEDs (two red, 
amber, and green), two ‘push to make’ buttons, 
and a single buzzer. These components lend 
themselves to many starter projects, and enable 
newcomers to explore the concepts of input 


A The JAM HAT adds six LED lights, two buttons, 
and a buzzer to the Raspberry Pi 


(buttons) and output (LEDs). For instance, 
you can build a traffic light system with a 
button crossing. 

Utilising Raspberry Pi's HAT (Hardware 
Attached on Top) framework means all you need 
to do for setup is slot the JAM HAT on top of a 
Raspberry Pi. Four metal standoffs are used to 
secure the JAM HAT to the Pi, making for a secure 
teaching device for the classroom. ModMyPi has a 
guide to getting started, walking you through the 
assembly and setup process (magpi.cc/GBRhJb). 


Code base 

The JAM HAT works with Python or Scratch. 

In Python, it makes use of the new GPIO Zero 
1.5 library, which makes it easier to connect 
buttons and LEDs together in Python. ModMyPi 
worked with the GPIO Zero code team to put 
together sample projects - you can find this 
selection of sample code on ModMyPi's GitHub 
site (magpi.cc/GZrVfm). 

Users at home might get more from wiring 
LEDs, buttons, and the buzzer directly to the GPIO 
pins via a breadboard. However, we think JAM 
HAT will be ideal for teachers looking for a neat 
classroom solution. It even has a passthrough 
GPIO header, so doesn't restrict students from 
attaching further components. ll 
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THE OFFICIAL The only guide you 
need to get started 
with Raspberry Pi 


H 
| OW to use your new Computer 


e Learn how to set up the Raspberry Pi, 
install an operating system, and start using it 


* Follow step-by-step guides to code your 
own animations and games, using both the 
Scratch and Python languages 


e Create amazing projects by connecting 
electronic components to the Pi's GPIO pins 


£10 with 
worldwide delivery 
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10 Best: 


Laptop kits 
&proJects ee 


A briefcase PC 


Another crowdfunded laptop, the CrowPi looks like a spy kit worthy 
Want to make your Pi more porta ble? of Bond himself. Full of cool components and connectivity, it's a 
great way to carry fun Pi-powered projects around with you. 
Here are some of the best ways... 
> £186 / $239 
> magpi.cc/DCAWER 


custom mini computers have always been 

a popular idea in the Pi community. As tech 
compatible with Pi and other hardware becomes 
more available, so has the feasibility of these kind of 
projects - so much so, that you can now get all-in-one 
computer kits. Here are some of our faves. WI 


m aspberry Pi devices powering old laptops and 


Computer Kit 
Touch 


Screen and keyboard, 
no folding 


Kano has been producing Pi- 
powered computer kits for years, 
and this version is a touchscreen 
tablet with an additional external 
keyboard. While not a traditional 
style of laptop, it does function 
fairly similarly to one. 


» £280/ $280 
> magpi.cc/gLpTVF 


pi-top 3 


| True original 


This lean, green, Kickstarted module laptop 
machine is the original Raspberry Pi laptop 
kit. There are several variations of it that sell 
for a wide variety of prices, but the original 
laptop configuration remains a favourite to 
this day. 


» £245/ $320 
> pi-top.com RasPad 


Raspberry Pi Tablet 


This tablet computer kit is an interesting 
implementation of the Raspberry Pi, as 
it's one part of tablet as well as one part 
mobile-powered Pi - you can easily 
hook it up to an HDMI display and any of 
your usual USB inputs at any time. 


> £238 / $259 
> magpi.cc/wpZiSS 
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LapPi Piper Computer Kit 2 


See-through DIY The play-chest computer 


Another educational computer kit, the Piper computer is laid out like 
a Pi-powered laptop but uses the space more efficiently for storage 

and setting up fun programming tasks. You can just install Raspbian 

on it, though, if you wish. 


This recent project from the 
folks at SB Components is 

a laptop that you not only 
build, but also see all the 
components inside when you're done! It comes in various sizes with > £274/ $299 
different audio solutions for all your budgetary needs. > playpiper.com 


> From £119 / $155 
> magpi.cc/igqsAs 


Mini Handheld Notebook 


Build from scratch 


This Adafruit project from the venerable 
Ruiz Bros lets you create a very tiny 

Pi laptop/netbook using a full-sized 
Raspberry Pi. You'll need to source 

the parts individually, although that 
does mean you can switch them for 


alternatives as you see fit. Lego Raspberry PiBook 


> magpi.cc/vnCQJR 


Dig out your bricks 


An oldie but a goodie 
i - while this project 

Portable Pi Laptop was designed with the 
original Pi Model B in 
mind (with an updated 
Pi Zero version later), 
the setup is very easy to 
modify so that you can 
use a more powerful 


Raspberry Pi 3B*. 


Barebones build 


Designed by Pi Supply to make use of 
its versatile PiJuice battery module, 
this very simple build uses the bare 
minimum of elements to make a 
laptop-like design possible. And it 
works just as well as the Kano and 
RasPad kits do! 


> magpi.cc/FJawXH 


> magpi.cc/SzyDbg 


— 
LAPTOP e 
Nano Pi2 UMPC BUILDS AND vi A 


Palm-sized laptop IDEAS! 


This is the smallest ‘laptop’ we've seen 
that makes use of a full-sized Raspberry Pi. 
It even features a neat clamshell design! some other laptop 
Again, you'll have to source all the parts building methods, take 
to make it yourself. It's well worth the a look at The MagPi #74 
effort, though. (magpi.cc/74) for our 
‘Build a laptop’ feature! 


If you fancy trying out 


> magpi.cc/TUULny 


10 Best Laptop kits & projects | magpi.cc | 8 


MM Magri | RESOURCES 


Everything you need to learn 
Game Development 


Here are some great sources for game-making tools and helpful tips from Mark Vanstone 


| Pygame and Pygame Zero ; 


Pygame community Python 3 is available with the module which does need a bit of 
development originally standard install of Raspbian. setting up in your code, but this 


started by | To get started writing games makes it very flexible. 
Pete Shinners 


quickly on the Raspberry Pi, If you want an even quicker 
Pygame Zero created there are a couple of Python result, you can use the Pygame 
and maintained by modules that you will want to Zero module; this does all the 
Daniel Pope investigate. The first, Pygame, setup behind the scenes and 
Sie provides all the functions you you can have your program if needed. Both Pygame and 
Free will need to create a game running with just a few lines Pygame Zero have had a tutorial 


window, draw to the screen, of code. Pygame Zero takes 
get input from the player, play care of most of the graphics 
sounds - in fact, everything handling and input with very 
you will need for a good game. simple functions, and can 
Pygame is quite a powerful be combined with Pygame 


series in The MagPi, which 
introduces all the capabilities of 
both modules. Start reading at 
issue 31 for Pygame, and issue 71 
for Pygame Zero. Ell 


magpi.cc/SkBPms 


Game assets 


Places to get graphics, sounds, and models 


TURBO SQUID 

Turbo Squid provides a huge range 
of 3D models and textures, both free 
and paid for, and includes some 
very high-quality assets for all types 
of games. Suitable for beginners to 
seasoned professionals. 
turbosquid.com 


OPEN GAME ART 


Community-provided graphics, models, 


and sounds. Most of the assets are 
provided under the Creative Commons 


or GPL licences. A great resource for 
getting together prototype ideas and 
supporting the artists. 
opengameart.org 


FREESOUND.ORG 


A searchable community-curated 


database of Creative Commons sounds. 


Here you will find both sound effects 
and also background music for your 
games. Most will require you to credit 
the author if you publish your game. 
freesound.org 
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í Sploder 


Community 
developed and run 


If you are more into designing 
games than coding them, 
then you will find Sploder very 


Price: i r ; ; 

Erco interesting. It is an online game 
builder for creating games 

sploder.com 


without coding. You can start 


with one of the many templates 
provided, and add graphics and 
sound from the Sploder libraries, 
or use your own. When you 

have finished your game, you 
can share it with your friends or 
even enter it into competitions. 
Because the game is played in 

a browser, it means that even 

if you make your game on a 
Raspberry Pi, it can be played on 
other types of computers or even 
mobile devices. There is lots 

of help on the website and the 
forums, and making your first 
game is only a few clicks away. El 


| AppGamekit 


The Game peas x) Dur 
Creators Ltd m. 
Price: 


Raspberry Pi and 
schools: Free 

Other versions: 
£60/$80, with add-ons 
from £20/$25 


magpi.cc/sZRSye 


Here's one for the slightly 
more advanced game creators. 
AppGamekKit has been available 
for some time on the PC, along 
with its companion product, 
GameGuru. Now AppGamekKit 
is available for the Raspberry 
Pi to build 2D and 3D games. 
The kit itself is a toolbox for 
game creation, including a code 
editor, and lots of example 
programs to get you started. 


The language used is a form 

of BASIC, showing the kit's 
heritage, originally developed 
by Lee Bamber, and called Dark 
Basic. The toolkit has moved on 
from then, and can be used to 
develop games that are cross- 
platform, including mobile. 
AppGamekit is flexible, suitable 
for writing publishable games, 
and many libraries of premade 
assets are available to buy. Hl 
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Learning 


resources 


Resources for learning 
to write great games 


CREATE YO 
ENTERTA 


GETTING STARTED WITH 
PYTHON VIDEOS 

If you are right at the 
beginning of your game coding 
career, then here is a very 
straightforward video series 
showing how to get started 
programming Python on the 
Raspberry Pi. 
magpi.cc/BaiJvS 


RASPBERRY PI PRESS 
BOOKS 

You will find several books 
that cover aspects of game 
development from Raspberry 
Pi Press, but Look for Make 
Games With Python, which will 
give you a comprehensive 
introduction to Python and 
Pygame game development. 
magpi.cc/gameswithpython 


RASPBERRYPI.ORG 

The main Raspberry Pi website 
has a wealth of game tutorials 
and examples. It covers 
making games with Scratch, 
Python, HTML, Minecraft, and 
extra hardware. This is a go-to 
resource if you are learning 
game development. 
magpi.cc/YtePEy 
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MägPi 


Hundreds of ninjas 
have taken part in the 
CoderDojo Collaborative 


magpi.cc 


Vaughn 


Can you be an exec that also runs a CoderDojo for Girl Scouts? Nikole can 


Category 
Website 


nlike a lot of event 

runners in the wider 

educational/Raspberry Pi 
community, Nikole never really 
planned to be one. 

“Alocal cybersecurity military 
non-profit group started the first 
known Dojos in San Antonio,” 
Nikole explains. “My kids and 
I [were invited] to join a Dojo 
to learn JavaScript. After two 
meeting dates, we received notice 
that the location was closing, and 


Nikole Vaughn 


Day job 


the Dojo needed a new gathering 
spot. I teach part-time for the 
University of Phoenix (UOP) 
in San Antonio, so the Dojo 
moved there for the remaining 
scheduled sessions. While sitting 
at UOP and checking-in the 
Ninjas, a realisation came to me: 
‘Pm now running the Dojo.’” 
She now runs her own 
CoderDojo with Malene 
Lawrence: the CoderDojo 
Collaborative at the San Antonio 


der Dojo 


College, which has been its 
home for two years. 

*The atmosphere is 
collaborative and community 
focused," Nikole tells us. 
“Everyone brings all of who 
they are and offers their talents 
to the group for the betterment 
of all involved." 


What is your CoderDojo like? 
The CoderDojo Collaborative 
has 141 registered Ninjas, six 


; P sus; N — = 


INTERVIEW | MägPi Wasa 


A Scratch is a popular topic for 
many students 


P There's about a 60/40 split 
between boys and girls at 
the Collaborative 


Volunteer Champions (Dee 
Arnold, Tracie Hervey, Sheri 
Brown, Shiketa Gresham, Malene 
Lawrence, and myself), 35 
Volunteer Professional Mentors, 


and 40 Non-technical Volunteers. 


We meet, for free, in nine 
dedicated spaces with computers 
at San Antonio College. We 
started with 20 Ninjas, two 
Champions, one Mentor, and no 
Non-Technical Volunteers. 
Ninjas choose one topic to 
cover for a period of eight to 


or coming to the Dojo. Parents 
are reporting that the Ninjas are 
choosing the Dojo more often, so 
are happy that we only meet two 
to three times per month, so that 
the kids can maintain their sports 
team position. 


M Everyone brings all of who they are 
and offers their talents to the group 
for the betterment of all involved EJ 


nine weeks, then can register 
for a different topic after a 
Promotion Ceremony. 


How have kids reacted to 

the CoderDojo? 

Over the three years in operation, 
we have had 480 registered 
Ninjas. Kids show up ready 

to be cool and have fun. Our 
Ninjas often face the Saturday 
morning dilemma of having to 
choose between participating 

in a sporting event with a team, 


What are some of your 
favourite projects that have 
been made at the Dojo? Reply 
from Steven Bernstein, a Raspberry 
Pi Mentor at the Collaborative: 
It’s been projects that open the 
eyes of the kids to possibilities. 
Seeing the LED on the 
breadboard brighten for the 
first time, driven by code they 
entered themselves, is thrilling. 
Some Ninjas have composed 
and played music using 
Python on the Raspberry Pi. 


Now Ninjas are learning 

how to create wearable and 
reactional Pi projects using 
LEDs. For interested Ninjas, 
one Mentor is teaching how 
to create a wearable WiFi hub 
using the Pi. 

The All About Me websites 
seem simple in concept, but 
really demonstrate the power 
of code. Ninjas bring their 
interests into the digital world 


using HTML, CSS, and JavaScript. 


One Ninja, who wanted to 
open a cupcake shop, created 
her own site with animated 
sprinkles falling from the sky 
onto cupcakes, while another 
Ninja created a site explaining 
his love of games like Minecraft. 
The Ninjas see that ideas in our 
natural world have life in the 
digital world. 

Other Ninjas created 70 
Scratch programs, ranging 
from an animated story book, 
to a ping-pong-like game, to 
a mathematical game to learn 
pre-algebra concepts. M 


Champions 
needed! 


Think you have the 
skills to help young 
people learn coding 
and other kinds of 
digital making and 
computing? Then 
you could become a 
CoderDojo Champion 
and help shape the 
next generation of 
computer users. Head 
to the volunteer page 
for more details: 
coderdojo.com/ 
volunteer 


(e) CoderDojo 
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This Month ` 
IN Raspberry Pi 


Coolest Projects USA 


CoderDojo's spectacular event returns to Los Angeles to showcase 
amazing American youngsters 


a matter of days until Coolest Projects 

International on 5 May in Dublin, the 
premier Coolest Projects events held by 
CoderDojo. In late March, we had the privilege to 
see some of the incredible projects that students 
across America had made at Coolest Projects USA. M 


B y the time you read this, it will be only 


01. The Discovery Cube in LA is 
a fantastic science museum, 
and a perfect home for 
Coolest Projects 


02. This huge auditorium was alive 
with the sounds of making 


03. From magic mirrors to robots 
and Minecraft hacks, there was 
a huge range of projects 


04. Thisis a very good rule for life 


05. Theclassic American school 
science fair info board was 
the primary way people were 
showing off their projects 


06. Hundreds of people attended 
from across the United States 


07. Judging was often a fun process 


08. RachelPizzolato is a host on 
MythBusters Jr, and drove 
overnight to be at the event 
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#MonthOfMa 


Part 2 


More marvellous March makes! 


through March, meaning there was still 


| ssue 80 went to print about halfway 


loads of time left for people to get making 
for the #MonthOfMaking! Here are some more 
amazing pics of your projects... M 


O 


Qo Izzy Bartley 


Who can resist this little #microbit 
micro:beastie? Look at her, she's all 
heart (and eyes...)! 


#edtech 
#MonthOfMaking 


Just created a ‘fruit piano’ for toucan class to 
use in their #music lesson with 
@TTMediaCompany this afternoon using a 
@makeymakey. #MonthofMaking 


=” 
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01. 


02. 


03. 


04, 


We definitely can't 
resist this cute 
micro:bit monster 


Fruit piano sounds 
amazing. Is there a 
banana horn? 


More beautiful laser 
cutting. We want a 
laser cutter now 


Something as simple as 
a custom frame/case 
is a great way to make 


king 


^ MakerspaceHull 


Cool stuff happening all the time here. This 
started life as a pencil sketch that we helped 
scan and convert to a scalable vector and it 
can now be laser cut or embroidered or 
anything... ’ 


EQ kawaq (om Y 
Custom stand/case for InkyWhat from 


@pimoroni and @Raspberry_Pi Zero 
#MonthOfMaking 


t 
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Raspberry Pi projects you 
can crowdfund this month 


WORLD'S ®Maussr 
POCKET LASER PICO 


PROJECTORS 


NanoSound DAC2 Nebra AnyBeam 


Our friends at Nanomesher have a new DAC on We love the idea of a tiny project that can just plug into 
Kickstarter: a new generation of their popular NanoSound a Pi so you can create an outdoor drive-in cinema with 
DAC. It's been improved with better sound output and very little equipment. Or spruce up a weekend in a cabin 
better components. We liked the originals, and we're by finding a blank wall to project onto. Anyway, this has 
interested to see how the DAC2 turns out. already been funded, so might be worth jumping on. 

> kck.st/2U60yre > kek.st/2FH1tq1 


Best of the rest! Here are some other great things we saw this month 


PI VIZUWALL | FRIDGE SECURITY CAMERA FREEPLAY CM3+ 

Friend of the magazine, Estefannie Computer vision via OpenCV ona This Game Boy Advance-esque retro 
Explains It All, notified us of this cool Raspberry Pi is very powerful. Powerful gaming handheld is one of the first we've 
project at Miami Maker Faire. It's a cluster enough to help protect your food from seen to implement a nice, low-profile dual 
computer, and each Pi flares out as it uses sneaky thieves in shared accommodation analogue control setup. The D-pad looks 
more CPU power. Expect a bigger write-up or an office. Adrian built a device to keep pretty good as well. 

in our next issue. his precious hummus safe from thieves. 


Your fridge was opened on 12 
Grimmauld Place at 


Wednesday, March 06 2019 at 
[Uh { 11:20AM for 8 seconds. 
> magpi.cc/jWMpPo > magpi.cc/ixrRyK > magpi.cc/qEVGYz 


Z 
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Raspberry Jam 
Event Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. LITORAL Raspberry JAM 


= Saturday 4 May 

® Colón 206, Parana, Argentina 

» magpi.cc/JJpSUF 

An open access event where people can learn about 
programming, electronics, and being creative. 


02. Castro Valley Raspberry Jam 

= Saturday 4 May and Sunday 5 May 

® Castro Valley Library, Castro Valley, CA, USA 

> magpi.cc/pYiwGm 

If you're interested in coding, visit the Castro Valley Jam 
for tinkering, coding, electronics, and fun! 


03. AWC Informatics / STEDY Raspberry Jam 
^ Monday 20 May 
® San Luis Middle School, San Luis, AZ, USA 


» codeyuma.org 
Arizona Western College and STEDY have partnered to 


bring a Raspberry Jam to Yuma County. 


04. Raspberry Jam Halifax 

5 Friday 24 May and Saturday 25 May 

® Halifax West High School, Halifax, UK 
> magpi.cc/JJvzQq 


There will be learning sessions, workshops, time to code, 


and time to share. 
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05. May Exeter Raspberry Jam 


= Saturday 4 May 

Q Exeter Library, Exeter, UK 

» magpi.cc/NqgSUC 

A monthly meeting for everyone interested in all things 
computers, microcontrollers, robotics, and making. 


06. Cornwall Tech Jam 

^ Saturday 11 May 

Q9 Bodmin Library, Bodmin, UK 

» cornwalltechjam.uk 

For anyone interested in technology. of all ages and 
abilities. Ask questions and learn about programming. 


FULL CALENDAR 


Get a full list of upcoming 


07. Perth Raspberry Pi Jam 

^ Tuesday 14 May 

Q Spacecubed, Perth, Australia 

» magpi.cc/CwpHpd 

The May Talk invites you to bring your projects along to 


events for May and 
beyond here: 


rpf.io/jam 


work on in a communal environment. 


08. Preston Raspberry Jam 

© Saturday 25 May 

Q9 Fulwood Library, Preston, UK 

» magpi.cc/ZaVRhB 

A free digital making event for all ages and skill levels. 
Beginners welcome. 
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Want a Raspberry Jam 
$ š Pid in your area? 
& 4 1 e 6 Want to start one? 
ë 6 Email Ben Nuttall about it: 

ë ; L $ jam@raspberrypi.org 

p ë 
eo 
ë 
é 


"1 


We've highlighted some of the areas 
in need of a Jam! Can you help out? 


Raspberry Jam advice: 


Promotion 


use Twitter and Facebook. I’ve found it useful 

| to get the message directly to schools who use 
Twitter, so the IT specialist can pass the 

message on to parents and children. I think .49 

old-fashioned posters put up around the area w 4 e e 


work well too.” ” < M Al 
y L f a> - 7 
^A P . 
Anne Carhill - York Raspberry Jam [24 o ^" 
E 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, < 
printed worksheets, stickers, flyers, and more. SUIDEBOOK 

Get the book here: magpi.cc/2q9DHfQ 
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Your 


Letters 


I was browsing through 

The MagPi #80 and found 

the ham radio section. Iam 
especially interested in the 
aircraft detection setup. I would 
like to know what does it take to 
make something like this, other 
than the Pi and the PiAware 
software? Does it take a certain 
radio-to-USB dongle, or what 
other hardware is required? 
Also, does it require an internet 
connection to the Pi? 


Timon via email 


A lot of the ham radio projects 
do require a radio dongle and 
antenna of some kind so it 

can receive radio signals, and 
this project in particular is no 
different. It does, however, 
require an internet connection 
as well, so you need to make sure 
it's connected to your wireless 
network or have a mobile 
hotspot with you if you're taking 
it into the wild. 


Contact us! 


» Twitter 


» Email 
» Online 
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» Facebook magpi.cc/facebook 


@TheMagPi 


magpi@raspberrypi.org 
raspberrypi.org/forums 


Power scale 


I’m trying to figure out what 
the more powerful Raspberry Pi 
models are - is it generally the 
newer the better? Would that 
make the Raspberry Pi 3A+ the 
most powerful version? Where 
does the Compute Module fit in 
all this? 


Frances vig email 


While ‘the newer the better’ 

is a pretty good rule of thumb, 
the model types (and price) also 
denote how ‘powerful’ they are. 
The Model B of a Raspberry Pi 
type is generally slightly more 
powerful than a Model A, as well 
as including more inputs and 
outputs and such. 


Y The Raspberry Pi 3B+ 
is currently the most 
powerful Pi 


In the case of the 3B+ and the 
3A+, the 3B+ has 1GB of RAM, 
while the 3A+ has 512MB. The 
3A+ doesn’t require as much 
power, though, and is a bit 
smaller, so it then comes down 
to what you need to use your 
Raspberry Pi for. The Pi Zero is 
smaller still, and only sports 
a single-core CPU, making 
it the least powerful of the 
current models. 

The Compute Module is 
generally as powerful as the 
Model B of the Pi generation 
it's based on. 

If you want a full breakdown 
of the specs, head to our 
benchmark page for full details: 
magpi.cc/benchmarks. 


Subscription queries 


Is there a way I can find out 
when my The MagPi subscription 
runs out? It must be about now, 
which is reinforced by the fact 
that one hasn’t come through 
my door this week. Anywhere I 
can log in to check? 


Torcrayth from the forums 


You can check your subscription 
details by heading to your account 
page - you'll find a link in the 
initial confirmation email for your 
subscription, and this applies 

for all print subscription types. 

If you don't have that email, 

you should contact magpi@ 
subscriptionhelpline.co.uk and 
the folks there should be able to 
sort it out for you. 
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Where to start 


I’m thinking of getting my 
eight-year-old their first 
Raspberry Pi - they’ve been 
playing with one at a friend’s 
house, and it seems like a great 
time to introduce them. What 
do you feel is a good starter kit 
for someone their age? 


Claire via Facebook 


There’s a couple of things we 
recommend for pretty much 
anyone to pick up if they want to 
get started with Raspberry Pi. 
The Official Starter Kit is 
definitely a great product 
to consider: it comes with a 
Raspberry Pi, keyboard, mouse, 
SD card, case, and the Official 
Raspberry Pi Beginner’s Guide. 


DAC+ ADC 


— oe eo 


Play back your MUSIC. 


RASPBERRY PI 
The pocket-sized desktop compute! 


PIZERO 


That’s 244 pages of expert tips 
that will help you make the most 
out of your new kit. 

For a slightly cheaper option, 
you should check out the Official 
Raspberry Pi Beginner’s Book 
(magpi.cc/beginners-book) 

- this comes with a Raspberry 
Pi Zero, SD card, case, and the 
adapters to connect it up. Both 
options are great, so go with 
what your budget allows! El 


Up to 192kHz/24bit 


Connect existing audio 
equipment and stream 
music over the network 


Create a Karaoke box 


Use the Raspberry Pi as 
an effects processor 


Record audio 


Create a web radio station 


www.hifiberry.com 


HackSpace 
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One of ten 
HiFiBerry 
DAC+ AD 


Last issue (magpi.cc/80) we put 


together an amazing karaoke 
machine that used on of these 
wonderful DAC+ ADCs. Now is 
your chance to win one. We have 
ten DAC+ ADCs to give away. 


m The DAC+ ADC not only 
offers your high-quality music 
playback on the Raspberry Pi, 
but also allows you to record sound 


from an analogue audio source E] 


- HiFiBerry In association with 


e, HiFiBerry 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/dQKrSL 


Terms & Conditions 


Competition opens on 24 April 2019 and closes on 30 May 2019. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, the 
prize supplier, their families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants' details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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The kids are alright 


The MagPi Features Editor Rob Zwetsloot is happy to find younger makers flourishing 


and making for over seven years 

now, much of that revolving 
around the Raspberry Pi. | think 
I've done some great stuff, and Pm 
especially proud of the work we do 
here in The MagPi to help inspire 
folks to get stuck in with digital 
making and programming, and 
building circuits and such. 

If you told me at 16 that I would 
be doing this for a living, I probably 


| ’ve been writing about computers 


So I gave up on that and pursued a 
different career. 


Python to the rescue 

A few things happened in my early 
adulthood to send me down my 
current path. The biggest one was 
that as an engineering student 

at university, I was introduced to 
Python. For the first time, I actually 
learnt how to code and it was like a 


new world had been opened up to me. 


M For the first time, | actually learnt how to 
code and it was like a new world had been 


opened up to me EJ 


wouldn't have believed you. First of all, 
Pd already decided writing for a living 
wasn't for me. Secondly, and most 
importantly, computing education 
when I was at school was complete 
trash. I joke to this day that I have 

a GCSE in Microsoft Office because 
honestly... that's what the curriculum 
was. Learn mail merge. Create a 
spreadsheet. Do some HTML. Build 

a database. I remember desperately 
wanting to learn to code and seeing 
that Visual Basic was an option to learn, 
but my teacher refused my request. 
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Since first learning to print ‘Hello 
World’ in Python, Ive written 
silly games, visual novel engines, 
automated drones, created cosplay 
electronics, and much, much more 
with it. Things that, at 16, I thought 
I'd never be able to do. 

I personally try to live life without 
regrets - who knows what amazing 
thing in my current life I'd lose if 
Pd done something significantly 
different? However, I am sad that I 
never got the chance to experiment 
with this kind of stuff as a kid. 


If you've ever met me and asked 
me about my job, Ive probably 
already told you the above story. 
Twice, possibly (m very sorry). I 
always cap it by saying that I am 
honoured to work with Raspberry Pi 
to help young people do what I could 
not, and that was never more evident 
than spending a day at a CoderDojo 
Coolest Projects event last month. 


A new era 

In this room full of makers ranging 
from 10 to 18, I saw incredible 
projects that put myself, and other 
makers, to shame. These kids and 
teens are getting to flex their creative 
muscles in an entirely different way, 
and it's all made possible thanks to 
new and improved resources, and a 
ton of affordable hardware to help 
them achieve their tech dreams. 

If what I do helps to inspire these 
people in even the slightest way, it 
makes all the hard work we put into 
The MagPi more than worth it. 7 


Rob Zwetsloot 


Rob is amazing. He's also the Features 
Editor of The MagPi, a hobbyist maker, 
cosplayer, comic book writer, and 
extremely modest. 
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Official case with three covers 
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Build your own credit card 
sized computer 


Get started with Programming 
Set up a Media Center 
Make simple electronic circuits 
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